Skip to content

docs: restructure, add cross-references to global themes documentation#5196

Merged
aditya-arolkar-swe merged 1 commit intomainfrom
devalog/global-themes
Apr 28, 2026
Merged

docs: restructure, add cross-references to global themes documentation#5196
aditya-arolkar-swe merged 1 commit intomainfrom
devalog/global-themes

Conversation

@devalog
Copy link
Copy Markdown
Collaborator

@devalog devalog commented Apr 28, 2026

Summary

Improvements to the global themes documentation and surrounding cross-references.

Page placement & references

  • Moved global-themes.mdx from Configuration → Customization (it's a branding mechanism that operates on the same fields already
    grouped under Customization, like header/footer and css/js)
  • Added a redirect from /learn/docs/configuration/global-themes → /learn/docs/customization/global-themes
  • Added a global-theme entry to the Core configuration list on the site-level settings page
  • Added cross-references from each fern docs theme command in the CLI reference back to the global themes page

Content cleanup on the global themes page

  • Renamed the "How it works" heading to "Set up a global theme" (it's a setup walkthrough, not a conceptual overview)
  • Converted the h3 step headings inside to components
  • Linked the action verb in each step (Export, Upload, List, publish command) to the relevant entry in the CLI command reference
  • Replaced the two flat lists in "What the theme controls" with a single Field / Owner / Description table; linked each field to its canonical reference
  • Integrated the override behavior into the section intro — explicitly calls out that local edits to theme-owned fields are
    overwritten on publish

@github-actions
Copy link
Copy Markdown
Contributor

@aditya-arolkar-swe aditya-arolkar-swe self-requested a review April 28, 2026 14:26
@aditya-arolkar-swe aditya-arolkar-swe merged commit 5ee9b8d into main Apr 28, 2026
3 checks passed
@aditya-arolkar-swe aditya-arolkar-swe deleted the devalog/global-themes branch April 28, 2026 14:27
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