Render pass comments updated

Signed-off-by: Hofi <hofione@gmail.com>

Author: HofiOne

_plugins/generate_links.rb

@@ -144,6 +144,11 @@ def generate_links(page, ids, titles)
   end # class LinkGen
 end # module jekyll
 
+# 1st pass (must be the first one, so this is a separate run in the CI build !!!)
+#
+# This is used now to
+#     - generate all the page, heading, and named anchor links to `${PROJECT_ROOT}/_data/links/`
+#
 Jekyll::Hooks.register :site, :post_render do |site|
   puts ""
   shoud_build_links = (ENV['JEKYLL_BUILD_LINKS'] == 'yes')

_plugins/generate_tooltips.rb

@@ -468,7 +468,7 @@ def JekyllTooltipGen_hack_description_in(page_has_subtitle, page_has_description
 $JekyllTooltipGen_should_build_tooltips = nil
 $JekyllTooltipGen_should_build_persistent_tooltips = nil
 
-# 1st pass
+# 2nd pass (1st pass is/must be generate_links.rb)
 #
 # This is used now to
 #       - set the page nav_ndx correctly to support our custom bottom collection elements navigator
@@ -520,7 +520,7 @@ def JekyllTooltipGen_hack_description_in(page_has_subtitle, page_has_description
   end
 end
 
-# 2nd pass
+# 3rd pass
 #
 # This is used now to
 #     - render the page content manually and create the autolinks and tooltips