docs(sections): add grid cards to configuration and internals index pages

tony · tony · commit 6dd0024f370d · 2026-03-24T03:57:46.000-05:00
why: Configuration and Internals were the only section indexes without
grid cards at the top. Configuration had cards at the bottom but not
above the fold. All other sections (CLI, Topics, Project) have cards
immediately after the heading.
what:
- configuration/index.md: add 1x3 responsive card grid at top linking
  to Top-level Options, Environment Variables, and Examples
- internals/index.md: add 1x2 responsive card grid for Architecture
  and Python API, hide toctree for sidebar-only nav
diff --git a/docs/configuration/index.md b/docs/configuration/index.md
@@ -6,6 +6,29 @@
 
 # Workspace files
 
+::::{grid} 1 2 3 3
+:gutter: 2 2 3 3
+
+:::{grid-item-card} Top-level Options
+:link: top-level
+:link-type: doc
+Session and window configuration keys.
+:::
+
+:::{grid-item-card} Environment Variables
+:link: environmental-variables
+:link-type: doc
+TMUXP_CONFIGDIR and other env vars.
+:::
+
+:::{grid-item-card} Examples
+:link: examples
+:link-type: doc
+Sample workspace configurations.
+:::
+
+::::
+
 tmuxp loads your terminal workspace into tmux using workspace files.
 
 The workspace file can be JSON or YAML. It's declarative style resembles tmux's object hierarchy: session, window and panes.
diff --git a/docs/internals/index.md b/docs/internals/index.md
@@ -11,8 +11,25 @@ If you are building an application with tmuxp, use the [CLI](../cli/index.md)
 or refer to the [libtmux API](https://libtmux.git-pull.com/api/).
 ```
 
+::::{grid} 1 1 2 2
+:gutter: 2 2 3 3
+
+:::{grid-item-card} Architecture
+:link: architecture
+:link-type: doc
+How the CLI dispatches to the workspace builder and libtmux.
+:::
+
+:::{grid-item-card} Python API
+:link: api/index
+:link-type: doc
+Internal module reference for contributors and plugin authors.
+:::
+
+::::
+
 ```{toctree}
-:maxdepth: 2
+:hidden:
 
 architecture
 api/index
