After seeing the backlash to the recent React docs setup update, I've tackled it myself.
I've put up a PR that reworks the "Create" page with better explanations and a "Start from Scratch" section that recommends Vite + routers:
https://github.com/reactjs/react.dev/pull/7618
I think this should make everyone happy!
I've put up a PR that reworks the "Create" page with better explanations and a "Start from Scratch" section that recommends Vite + routers:
https://github.com/reactjs/react.dev/pull/7618
I think this should make everyone happy!
Comments
- Still recommends frameworks as the best default, and explains _why_
- Gives directions to learners or those wanting a simpler setup, _and_ recommends commonly used tools
- Improves the tone and provides more background
- Mentions CRA is dead
I copied sections from the "Sunsetting CRA" blog post and added more overviews of "MPA/SPA/SSG", plus guidance on what to consider when choosing architectures for your app.
I'm hopeful that we can get buy-in from the React team and this PR merged.
I think it should address all the major concerns from the community, while keeping the React team's overall guidance, and everybody wins.
Please check out the PR!
I got a lot of positive feedback on the draft, but also some "too long, too negative" comments.
The React team reached out to hear my feedback and we had multiple calls. I opted to give them time to do the docs update and see what other changes they were working on.
I'm still debating what to do with the rest. I think there's value in seeing the history, but not sure how to split or reformat that content.
So, holding off for the moment and I'll try to figure it out soon.