Add comments to explain why delays are needed

Signed-off-by: Paul Gooderham <[email protected]>

Author: turkeylurkey

src/test/java/io/openliberty/tools/intellij/it/UIBotTestUtils.java

@@ -427,14 +427,16 @@ public static void openLibertyToolWindow(RemoteRobot remoteRobot) {
         Exception error = null;
         for (int i = 0; i < maxRetries; i++) {
             try {
-                TestUtils.sleepAndIgnoreException(10);
+                TestUtils.sleepAndIgnoreException(10); // wait for UI to be rendered before searching for a button
                 error = null;
                 ProjectFrameFixture projectFrame = remoteRobot.find(ProjectFrameFixture.class, Duration.ofSeconds(10));
                 projectFrame.getBaseLabel("Liberty", "5");
                 break;
             } catch (WaitForConditionTimeoutException wfcte) {
                 // The Liberty tool window is closed. Open it.
                 clickOnWindowPaneStripeButton(remoteRobot, "Liberty");
+                // After clicking it can take seconds for the window to open on a slow cloud machine.
+                // Important since this is in a loop and you may click twice if there is no sleep.
                 TestUtils.sleepAndIgnoreException(5);
                 break;
             } catch (Exception e) {