[Docs Rewrite] Meta-Issue: Overview
See original GitHub issueThis is the parent tracking issue for all the work we’d like to do, and primarily serves to link to the other issues.
I’m initially basing this off my suggested outline for the new docs structure and content. This is absolutely not final, and I expect us to iterate on this a lot as we work through everything.
For now, I’m organizing the top-level task list by category / docs structure section.
Tasks
- Guided Learning Paths (#3591)
- General Content Improvements (#3593)
- “Introduction” section (#3594)
- “Tutorials” section (#3595)
- “Recipes” section (#3596)
- “FAQ” section (#3597)
- “Real World Usage” section (#3598)
- “Using Redux with a UI” section (#3599)
- “Understanding Redux” section (#3600)
- “Style Guide” section (#3601)
- “Other” section and content (#3602)
- Redux Starter Kit section (#3614 )
- Examples (#3917)
Planning / Discussion Topics
- Docs writing guidelines and issue templates (#3609 )
- Ideas from other docs sites and user feedback (#3615 )
Notes
Any pages that are moved around must update our Netlify redirects
file so that visitors see the new page.
Questions for Discussion
- Should we keep everything on a single
docs-rewrite
integration branch, or should we just go ahead and updatemaster
piecemeal as we go so that we get the initial benefits? I’m inclined to put changes intomaster
as soon as we’re happy with them.
Issue Analytics
- State:
- Created 4 years ago
- Reactions:11
- Comments:26 (16 by maintainers)
Top Results From Across the Web
[Docs Rewrite] Meta-Issue: Tutorials #3595 - reduxjs/redux
This is a tracking issue to cover all tasks related to rewriting and updating the "Tutorials" section. Tasks. Define goals and outline for...
Read more >Mark Erikson on Twitter: "The goals for the rewrite were: - Improve ...
This is a complete rewrite of the old "Basics/Advanced" tutorial, and teaches "how ... [Docs Rewrite] Meta-Issue: Overview · Issue #3592 · reduxjs/redux....
Read more >Problem: why isn't my API displayed? Metaproblem
Metaproblem : how to debug API definitions? ... I've found that I can make any sort of change to the resource definition, even...
Read more >Issue scope guidelines for Drupal core issues
However, contributors must then understand (and review and improve) ... planned change, and document this information in the issue summary.
Read more >What's New In Python 3.6 — Python 3.11.1 documentation
Semantics of the API will change with Python as necessary. See also ... See the summary of PEP 519 for details on how...
Read more >Top Related Medium Post
No results found
Top Related StackOverflow Question
No results found
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start FreeTop Related Reddit Thread
No results found
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Hashnode Post
No results found
Top GitHub Comments
Some feedback from a random HN user ( https://news.ycombinator.com/item?id=21927109 and https://news.ycombinator.com/item?id=21927800 ):
Key point:
I think this matches up with my desire for a “quick start” page that teaches RTK and React-Redux right away.
Suggestion to have the Redux docs mention that “spreading out state mutation is a bad idea”:
https://news.ycombinator.com/item?id=22333526