Skip to content

docs: show child links on Expression Compatibility page#4319

Merged
andygrove merged 1 commit into
apache:mainfrom
andygrove:docs-expression-compat-nav
May 14, 2026
Merged

docs: show child links on Expression Compatibility page#4319
andygrove merged 1 commit into
apache:mainfrom
andygrove:docs-expression-compat-nav

Conversation

@andygrove
Copy link
Copy Markdown
Member

Summary

  • The Expression Compatibility index page uses a :hidden: toctree, so the page body ends after "Compatibility notes are grouped by expression category:" with no visible links to the nine category sub-pages (aggregate, array, cast, datetime, map, math, misc, string, struct).
  • The top-level user-guide toctree uses :maxdepth: 1, so those category pages also don't appear in the sidebar nav.
  • Drop :hidden: and raise :maxdepth: to 2 on compatibility/expressions/index.md so Sphinx renders the linked list inline.

Test plan

  • Build docs locally and confirm the Expression Compatibility page now shows links to each category sub-page.

The toctree on the Expression Compatibility index used `:hidden:`, leaving
the page with no visible way to navigate to its category sub-pages
(aggregate, array, cast, datetime, map, math, misc, string, struct).
Drop `:hidden:` and raise `:maxdepth:` to 2 so Sphinx renders the child
links inline.
Copy link
Copy Markdown
Contributor

@mbutrovich mbutrovich left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @andygrove!

@andygrove andygrove merged commit c12b8e3 into apache:main May 14, 2026
6 checks passed
@andygrove andygrove deleted the docs-expression-compat-nav branch May 14, 2026 13:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants