Comments (2)
I'm slightly against this proposed change because- at the moment- it would more tightly couple the side-nav YAML config files to the markdown content. As it is, changing an article title (in markdown) or adding a new markdown file requires someone to remember to also update the YAML file. This proposed change would require more edits (to ensure that anchor tags stayed in sync).
Ideally I would like to actually remove those YAML files entirely and have the side-nav be generated programmatically based on markdown content. At this point it would be possible to add section headers (although I'd love to hear @joecritch's opinion on the UI/UX of this).
Related, if this gets implemented I think the nav should also have some sort of scrollspy to make it apparent which (sub)section you're on. The lack of it is already noticeable in the tutorial (the section that was initially clicked on stays highlighted no matter where you are in the document).
This has always been on our roadmap for the Tutorial 😄 Just haven't had time to add it yet. There's an issue for this FWIW (#10984).
from react.dev.
This issue doesn't seem relevant anymore since now the docs provides header based navigation.
from react.dev.
Related Issues (20)
- [Mistake]: React 19 says that startTransition callback must be synchronous. It is not true. HOT 1
- React Fiber documentation not present in the current Docs
- [Bug]: ERR_SSL_PROTOCOL_ERROR on Translations Page
- [Suggestion]: Update the starter code in sandbox of Tic tac toe game tutorial
- [Suggestion]: Improve code in Tic-Tac-Toe demo HOT 3
- [Suggestion]: How to avoid null checks when initializing useRef later
- Doc not found: https://react.dev/contributing/design-principles.html
- [Bug]: No Mention of RFCs (or ANY Way to Provide Feedback) on Site HOT 1
- React components should be pure, not "idempotent" HOT 2
- page does not exist HOT 1
- Fetching data with Effects
- [Bug]: The sandpack bundler aint working HOT 1
- [Bug]: Missing explanation
- [Suggestion]: Reference: component prop list shoud be more readable
- [Suggestion]: Broken link in README.md for react-html package HOT 4
- [Suggestion]: items in the sidebar tree should collapse on clicking.
- [Typo]: Minor typo in Updating Objects in State HOT 2
- Several pages not found in Prerequisites at React Fiber Architecture.
- Link in react console warning is not found
- Broken warning URL in console HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from react.dev.