Add comments to clarify the visibility testcases

modules/integration/tests-integration/tests-backend/src/test/java/org/wso2/am/integration/tests/api/lifecycle/APIVisibilityByRoleTestCase.java

@@ -221,6 +221,11 @@ public void initialize() throws Exception {
     }
 
 
+    /**
+     * Although API visibility on the dev portal is restricted (eg, to the 'admin' role), if a user has the
+     * 'internal/publisher' role, the API should still be visible to them.
+     * This ensures that publishers can view all APIs of the organization on the publisher
+     */
     @Test(groups = {"wso2.am"}, description = "Test the visibility of API in Publisher for API creator ")
     public void testVisibilityForCreatorInPublisher()
             throws APIManagerIntegrationTestException, MalformedURLException, XPathExpressionException, ApiException {
@@ -270,7 +275,11 @@ public void testVisibilityForCreatorInPublisher()
                    getAPIIdentifierString(apiIdentifierSubscriberVisibility));
     }
 
-
+    /**
+     * Although API visibility on the dev portal is restricted (eg, to the 'admin' role), if a user has the
+     * 'internal/publisher' role, the API should still be visible to them.
+     * This ensures that publishers can view all APIs of the organization on the devportal
+     */
     @Test(groups = {"wso2.am"}, description = "Test the visibility of API in Store for API creator",
           dependsOnMethods = "testVisibilityForCreatorInPublisher")
     public void testVisibilityForCreatorInStore()