61438453e9f8be7a5949725a688ac6cf709add28
lrnassar
  Tue Apr 28 13:06:10 2026 -0700
Restructure /docs/ landing page for new users; add docs-page styling. refs #36894

docs/index.md: rewrite as a beginner-first landing page. Replace the prior
five-section structure with a flat five-H2 outline -- Tutorials, Visualize
your own data, Share your work, Download data, Get help -- so every entry
in the sidebar TOC maps to specific content rather than to a vague
grouping. Promote the tutorial table from a buried H3 to top-level
content. Drop sections that don't serve new users (the "Understanding
assemblies/annotations" primer, the MySQL bullet, the mirror paragraph,
the Multi-Region View specific mention, and the four scattered "Relevant
FAQs" lists). Consolidate help into a single closer with contact, FAQ,
workshops, and the suggestion form. Distinguish custom tracks vs track
hubs ("simpler option" vs "more powerful and configurable"). Make
tutorial titles the table links and drop the redundant Link column.

docs/staticPage.lua: add a docs-page class to the row wrapper so /docs/-
only CSS can be scoped without affecting other gbsPage static pages.

src/hg/htdocs/staticStyle/gbStatic.css: add scoped .docs-page styles for
the sidebar TOC ("On this page" label) and tables (roomier padding,
zebra striping using the existing tr.even/tr.odd classes, subtle hover).
All new rules are namespaced under .docs-page so the rest of the site is
untouched.

diff --git docs/staticPage.lua docs/staticPage.lua
index 615beda2a3d..31aba84f10c 100644
--- docs/staticPage.lua
+++ docs/staticPage.lua
@@ -124,32 +124,33 @@
     add("     INSTRUCTIONS TO COMMIT THIS PAGE INTO git.")
     add("     Please read the file kent/src/product/Note-To-QA.txt for details.")
     add("     -->")
     add("<!--#set var=\"TITLE\" value=\"" .. metadata["title"] .. "\" -->")
     add("<!--#set var=\"ROOT\" value=\"" .. (variables["ROOT"] or metadata["ROOT"] or "..") .. "\" -->")
     add("")
     add("<!-- Relative paths to support mirror sites with non-standard GB docs install -->")
     add("<!--#include virtual=\"$ROOT/inc/gbPageStart.html\" -->")
     add("<link rel=\"stylesheet\" href=\"<!--#echo var=\"ROOT\" -->/style/bootstrap-3-3-7.min.css\">")
     add("")
     add("<h1>" .. metadata["title"] .. "</h1>")
   else
     add("<h1>No title defined in document, first line must be % mytitle </h1>")
   end
 
-  -- Sidebar TOC + body in Bootstrap grid
-  add('<div class="row docs-toc-row">')
+  -- Sidebar TOC + body in Bootstrap grid. The docs-page class scopes
+  -- /docs/-only typography and table styling in gbStatic.css.
+  add('<div class="row docs-toc-row docs-page">')
   add('<div class="col-md-2 hidden-sm hidden-xs">')
   add('<nav class="docs-toc" id="docs-toc">')
   add('<ul>')
   for i, h in ipairs(headers) do
     add("<li><a href='#" .. h.id .. "'>" .. h.text .. "</a></li>")
   end
   add('</ul>')
   add('</nav>')
   add('</div>')
   add('<div class="col-md-10">')
   -- ucsc change end
 
   add(body)
   add('</div>') -- close col-md-10
   add('</div>') -- close row