Skip to content
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

tutorial: improve table-of-contents accessibility #892

Closed
jpaquim opened this issue Nov 26, 2024 · 1 comment
Closed

tutorial: improve table-of-contents accessibility #892

jpaquim opened this issue Nov 26, 2024 · 1 comment

Comments

@jpaquim
Copy link
Contributor

jpaquim commented Nov 26, 2024

I've mentioned this in the past here: sveltejs/svelte#4673

It's still an issue, using a giant <select> element and requiring JavaScript for basic navigation within the tutorial pages is not a great user experience. I'd expect some kind of actual table-of-contents type of navigation with anchor elements for easier navigation. In particular, it would make it much easier to open different steps in different browser tabs, which would facilitate actually "working with" rather than "working through" the tutorial, and using it more as a reference for certain patterns. I guess after the first run through, the tutorial access pattern should in general switch to random-like, rather than linear.

It's ok if the full ToC is in another (dedicated) page, or within some collapsible section, or similar, tucked away for power users only. It would also help if the breadcrumbs indicating the current section/sub-section were actually usable for navigation rather than only indicative.

@jpaquim
Copy link
Contributor Author

jpaquim commented Dec 9, 2024

I think this can be closed with b1cb6c7 being merged, thank you!

@jpaquim jpaquim closed this as completed Dec 9, 2024
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

No branches or pull requests

1 participant