2761: added some comments

diff --git a/apps/workbench/test/diagnostics_test_helper.rb b/apps/workbench/test/diagnostics_test_helper.rb
index 392e7d0fd0368af26d1eb395d5bf640fb9eeabf8..01d351a2b6a82f68227d12609cdbb02a67598ea7 100644 (file)
--- a/apps/workbench/test/diagnostics_test_helper.rb
+++ b/apps/workbench/test/diagnostics_test_helper.rb
@@ -7,6 +7,8 @@ require 'yaml'
 
 class DiagnosticsTest < ActionDispatch::IntegrationTest
 
+  # Prepends workbench URL to the path provided and visits that page
+  # Expects path parameters such as "/collections/<uuid>"
   def visit_page_with_token token_name, path='/'
     workbench_url = Rails.configuration.arvados_workbench_url
     if workbench_url.end_with? '/'
@@ -16,6 +18,7 @@ class DiagnosticsTest < ActionDispatch::IntegrationTest
     visit page_with_token(tokens[token_name], (workbench_url + path))
   end
 
+  # Looks for the text_to_look_for for up to the max_time provided
   def wait_until_page_has text_to_look_for, max_time=30
     max_time = 30 if (!max_time || (max_time.to_s != max_time.to_i.to_s))
     Timeout.timeout(max_time) do