Skip to content

Update to TOM documentation theme#1476

Open
rachel3834 wants to merge 5 commits intodevfrom
docs/update_theme
Open

Update to TOM documentation theme#1476
rachel3834 wants to merge 5 commits intodevfrom
docs/update_theme

Conversation

@rachel3834
Copy link
Copy Markdown
Contributor

I felt it was time to update the theme used for the Toolkit's documentation on ReadTheDocs.

This PR implements just the new theme and the necessary dependencies. I'm considering it preliminary because I'd like to do some reorganization of the menu structure to make it more navigable within this theme, but I thought that would be too much for a single PR. So I'm submitting this now to get some feedback

@jchate6 jchate6 moved this to Needs Review in TOM Toolkit Mar 26, 2026
@jchate6 jchate6 self-assigned this Mar 27, 2026
@jchate6 jchate6 linked an issue Apr 8, 2026 that may be closed by this pull request
Copy link
Copy Markdown
Contributor

@jchate6 jchate6 left a comment

Choose a reason for hiding this comment

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

This looks great!

However, I'm not a huge fan of the navigation in this format.
A horizontal nav bar doesn't lend itself well to our current list of categories.
I think if we adopt this we will want to change our tree substantially.

@rachel3834
Copy link
Copy Markdown
Contributor Author

Thanks for your feedback @jchate6 !
Yes, I agree the navigation needs a revamp. I just wanted to get your input on the underlying theme changes before I go ahead with that. But I think this is a good chance to update the navigation in general, so that'll be my next step.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Needs Review

Development

Successfully merging this pull request may close these issues.

Implement new RTD theme

2 participants