doc/starlight: split sidebar into categories#22481
Conversation
7408e05 to
0a62450
Compare
|
Can we creep a |
oki |
|
Done, was able to update everything to the very latest version (Should have received some nice Typescript and Astro speedups) |
|
Since you updated astro and starlight I figure it is now using the satteri markdown parser, which means it is likely that the image zoom is not working anymore eand GitHub emojis potentially also not. Have you verified? I cannot test it I am on the train. If something is broken you can set the markdown parser to "unified", which should restore compatibility. In this case please add a comment to remove this once the plugins work. |
|
Regarding the sidebar split, I personally find this ui concept confusing, (but maybe this is just me xD) |
We (starlight itself?) still use the old one, it gives us a deprecation warning for now |
The alternative is to have a lot of collapsed sidebars or a very lengthy sidebar, both feel clunky. I'm open to other alternatives, |
Contribution description
While its a neat problem to have, the starlight documentation has become way too big for a singular sidebar, esp. with the upcoming #21582 and #22460. Thus I decided to split it into three categories for now using the plugin by HiDeo (we already use one plugin by him and he is also a core maintainer of starlight [Was always really helpful when we had issues too 😄]).
I decided not to move the slugs around for now (except for the networking category required for the other PRs), every time we change the slug we need to add a redirect for it which felt a bit annoying.
Before
After
Testing procedure
make doc-starlightIssues/PRs references
Declaration of AI-Tools / LLMs usage:
AI-Tools / LLMs that were used are: