Draft PR to get some feedback first, no need to review yet.
I've been thinking about this for awhile now and one thing I'd like to better showcase is that Bootstrap is extremely customizable, starting with v5. A "theming" page within the Getting started
section just doesn't feel right anymore. The content represents more than theming, and it's also not really a "getting started" subject.
I swear I'm not making everything a top level nav group. This one feels more important to me with the level of customization we provide, the conversations in other communities around theming (looking at you, React), and the still thriving themes marketplaces out there (not just ours).
Thoughts? What's missing from this section/subject?
Summary of changes
- Deleted the Theming page and expanded it unto an entire section called Customize
- New Customize > Overview page exists just to summarize this section.
- Sass page includes some updated headings, and adjusted content around Sass map modifications.
- Options page doesn't add much new, but I have renamed two of the super long options to better match the others.
- Color page moves theme colors to the top, combines the previous iteration of the All colors and Grays sections, and adds two swatches for white and black.
After discussion todos
Once I hear from folks, I'll get to work on the following:
-
Redirects from old page -
Audit and rewrite content -
Fix broken options table -
Update lists of options -
Update Color page after #29348 merges
New discussion todos after 3/1
-
Rename the overview into an index? Make the index the default for each section with this -
Components page likely needs to be moved to another page, or have it's contents changed—this feels more like an approach doc right now. -
Add new section for extending via plain CSS? -
Finish optimize page