Add comments to explain why we need to pause

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

Author: turkeylurkey

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

@@ -1104,6 +1104,7 @@ public static void insertConfigIntoConfigFile(RemoteRobot remoteRobot, String fi
                 keyboard.enter();
 
                 keyboard.enterText(configNameSnippet);
+                // After typing it can take 1 or 2s for IntelliJ to render diagnostics etc. Must wait before continuing.
                 TestUtils.sleepAndIgnoreException(5);
 
                 // Narrow down the config name completion suggestions in the pop-up window that is automatically
@@ -1124,6 +1125,7 @@ public static void insertConfigIntoConfigFile(RemoteRobot remoteRobot, String fi
                 keyboard.hotKey(VK_END);
 
                 keyboard.enterText(configValueSnippet);
+                // After typing it can take 1 or 2s for IntelliJ to render diagnostics etc. Must wait before continuing.
                 TestUtils.sleepAndIgnoreException(5);
 
                 if (completeWithPopup) {