3 ms·
I think a lot of the complexity comes from the incredible specificity of the docs. The authors intend to _teach_, which while great (thank you) it can seem over
by cnp 10y ago
I think a lot of the complexity comes from the incredible specificity of the docs. The authors intend to _teach_, which while great (thank you) it can seem overly complex for users who first land there.
I think a "Quick Start" section would solve a lot of the so-called "complexity" issues, showcasing a few common use-cases:
- Without React
- With React
Put bare-bones code under each of those sections and then let the user learn the particulars as they come (and as their projects demand)
- jaredsohn 10y agoWithout Redux - With Redux
- deleted 10y ago[deleted]
- deleted 10y ago[deleted]
- acemarke 10y agoI'm currently the primary maintainer doing stuff with Redux docs. Right now my focus is on a tutorial series I'm writing for my own blog, but any PRs to help improve the Redux docs are absolutely appreciated!
- cnp 10y agoWill give it a look tomorrow :thumbsup: