-
Notifications
You must be signed in to change notification settings - Fork 426
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
rewrite docs suggestion #1231
Comments
we're always interested in making things better but it's not clear how that is true with starlight. |
I can I think of a few improvements on top of the ones I mentioned. Starlight comes with copy and paste buttons for code blocks, "gives you built-in frontmatter validation with TypeScript type-safety", built-in components, and in my opinion custom block containers (tip, caution, and note) that are visually styled better. |
And does it support styling/highlighting nushell language syntax? |
Yes. https://github.com/shikijs/textmate-grammars-themes/blob/main/packages/tm-grammars/README.md |
It would be nice to have something that supports tree-sitter-nu too at some point. That grammar is coming along nicely. |
Would you be interested in a PR to see what the site would look like using Starlight? |
I personally wouldn't mind seeing a PR but it would have to:
|
There are two things I most care about:
|
I'd like to consider closing this as a duplicate of #1126 and continuing the discussion there. If agreed, go ahead and close it. I'll then copy over a summary of new information in this issue so it can be consolidated in one place. |
ya, seems like a dupe to me. thx. |
I think a docs rewrite using starlight would be great enhancement for the site. It could benefit from better performance and accessibility, improved SEO, can maintain the existing design with a more streamlined look and has a excellent developer experience.
The text was updated successfully, but these errors were encountered: