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 src/hg/htdocs/staticStyle/gbStatic.css src/hg/htdocs/staticStyle/gbStatic.css
index 537dacd1055..4509b5976ea 100644
--- src/hg/htdocs/staticStyle/gbStatic.css
+++ src/hg/htdocs/staticStyle/gbStatic.css
@@ -357,30 +357,71 @@
     text-decoration: none;
     border-left: 3px solid transparent;
 }
 
 .gbsPage .docs-toc li a:hover {
     color: #4c759c;
     border-left-color: #ddd;
 }
 
 .gbsPage .docs-toc li.active > a {
     color: #4c759c;
     font-weight: bold;
     border-left-color: #4c759c;
 }
 
+/* "On this page" label above the sidebar TOC */
+.docs-page .docs-toc::before {
+    content: "On this page";
+    display: block;
+    font-size: 11px;
+    font-weight: 600;
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+    color: #6c757d;
+    padding: 2px 12px 8px;
+    margin-bottom: 4px;
+    border-bottom: 1px solid #ededed;
+}
+
+/* Tables on /docs/ pages: roomier padding, zebra striping, and a subtle hover */
+.docs-page table {
+    margin: 16px 0;
+    border: 1px solid #ddd;
+    border-collapse: collapse;
+}
+
+.gbsPage .docs-page th,
+.gbsPage .docs-page td {
+    padding: 10px 14px;
+    border-bottom: 1px solid #ededed;
+}
+
+.gbsPage .docs-page th {
+    background-color: #f3f3f3;
+    border-bottom: 2px solid #cfcfcf;
+    font-weight: 600;
+}
+
+.docs-page tr.even td {
+    background-color: #fafafa;
+}
+
+.docs-page tr:hover td {
+    background-color: #eef4f9;
+}
+
 /* Bootstrap collapse component CSS (not included in our customized bootstrap.min.css) */
 .collapse {
     display: none;
 }
 
 .collapse.in {
     display: block;
 }
 
 .collapsing {
     position: relative;
     height: 0;
     overflow: hidden;
     transition-property: height, visibility;
     transition-duration: .35s;