3 ms·

In the past the Redux docs were something that was really hard for me to follow. I can't be super precise with my feedback, but the docs weren't able to cleanly

In the past the Redux docs were something that was really hard for me to follow. I can't be super precise with my feedback, but the docs weren't able to cleanly explain the concepts and the React example was hard to follow. I had to learn from Youtube tutorials. Thanks for rewriting them!

acemarke 6y ago
You're welcome! We've actually gotten many compliments about our docs over the years, but per that "Overview" issue, there's a lot of improvements that can be done. Also, "modern Redux" code with Redux Toolkit and the React-Redux hooks API is very different than the Redux code you'd have written even just a couple years ago, and we wanted to teach those approaches as the default. We also added a "Style Guide" page [0] that lists our recommended best practices, and that's been a big help for a lot of people. Sadly, we can't do anything about the tens of thousands of existing Redux tutorials out there, and I keep seeing people post new Redux tutorials even now that don't make any mention of RTK at all. Kinda frustrating, but all I can do is keep trying to improve our docs, answer questions, and let people know that it's a lot easier to learn and use Redux today. [0] https://redux.js.org/style-guide/style-guide https://redux.js.org/style-guide/style-guide
- jayparth 6y ago
  To your point, I had never heard of Redux toolkit or those hooks. Thank you for sharing!
- Aeolun 6y ago
  To be fair, a lot of people that started their project a few years ago might never have heard of redux toolkit. I only know of it because I read hackernews. I don’t think I really ever have to look at the redux docs, which probably doesn’t help.
  - acemarke 6y ago
    Yeah, that's one of my ongoing frustrations as a maintainer :) I've always gone straight to a tool's docs when I want to start learning it. I look for other sources, too, but I start with the docs, and I always assumed other people did, too. That's definitely not the case - many people deliberately _don't_ look at docs [0]. I definitely don't expect everyone with an existing Redux codebase to know that RTK exists already (although sure, I'd love to wave a magic wand and update every Redux codebase to RTK overnight). But it is sad to see new tutorials being posted that A) don't teach anything new compared to the plethora of existing tutorials, and B) continue to teach older patterns that are the same things people have complained about Redux over the years. So, even though I'm spending a lot of time updating our docs and highlighting RTK as the default way to use Redux, many people just rely on whatever other courses and tutorials they've looked at for their knowledge. [0] https://twitter.com/acemarke/status/1213898963679633411 https://twitter.com/acemarke/status/1213898963679633411

acemarke 6y ago

You're welcome! We've actually gotten many compliments about our docs over the years, but per that "Overview" issue, there's a lot of improvements that can be done. Also, "modern Redux" code with Redux Toolkit and the React-Redux hooks API is very different than the Redux code you'd have written even just a couple years ago, and we wanted to teach those approaches as the default. We also added a "Style Guide" page [0] that lists our recommended best practices, and that's been a big help for a lot of people. Sadly, we can't do anything about the tens of thousands of existing Redux tutorials out there, and I keep seeing people post new Redux tutorials even now that don't make any mention of RTK at all. Kinda frustrating, but all I can do is keep trying to improve our docs, answer questions, and let people know that it's a lot easier to learn and use Redux today. [0] https://redux.js.org/style-guide/style-guide https://redux.js.org/style-guide/style-guide

jayparth 6y ago
To your point, I had never heard of Redux toolkit or those hooks. Thank you for sharing!
Aeolun 6y ago
To be fair, a lot of people that started their project a few years ago might never have heard of redux toolkit. I only know of it because I read hackernews. I don’t think I really ever have to look at the redux docs, which probably doesn’t help.
- acemarke 6y ago
  Yeah, that's one of my ongoing frustrations as a maintainer :) I've always gone straight to a tool's docs when I want to start learning it. I look for other sources, too, but I start with the docs, and I always assumed other people did, too. That's definitely not the case - many people deliberately _don't_ look at docs [0]. I definitely don't expect everyone with an existing Redux codebase to know that RTK exists already (although sure, I'd love to wave a magic wand and update every Redux codebase to RTK overnight). But it is sad to see new tutorials being posted that A) don't teach anything new compared to the plethora of existing tutorials, and B) continue to teach older patterns that are the same things people have complained about Redux over the years. So, even though I'm spending a lot of time updating our docs and highlighting RTK as the default way to use Redux, many people just rely on whatever other courses and tutorials they've looked at for their knowledge. [0] https://twitter.com/acemarke/status/1213898963679633411 https://twitter.com/acemarke/status/1213898963679633411