3 ms·
> Even the example in redux's own docs is unnecessarily complex. Well here's the issue, because if the project docs are unnecessarily complex then what hope do
by yawaramin 7y ago
> Even the example in redux's own docs is unnecessarily complex.
Well here's the issue, because if the project docs are unnecessarily complex then what hope does anyone have of learning the correct way? Come to HN and read your comment?
No–the official documentation needs to speak for itself and be judged on its own merits. If you feel so strongly about how Redux should be taught, you can always send them a PR rearranging the docs and stay on them until it gets merged :-)
- dragonwriter 7y ago> Well here's the issue, because if the project docs are unnecessarily complex then what hope does anyone have of learning the correct way? The same way one learns about anything the correct way; the Tao that can be told is not the true Tao. > No–the official documentation needs to speak for itself and be judged on its own merits. Sure the documentation needs to stand on its own merits, as does he code itself. That's different than judging the code by the (de)merits of the documentation though. “Redux is too complex” and “Redux has less-than-ideal documentation from an introductory perspective” are both potential problems, but they are distinct problems.
- acemarke 7y agoI will gladly take any suggestions on how we can improve the docs in general, and the tutorials specifically :)
- dragonwriter 7y agoJust to be clear, I wasn't saying Redux has such a problem with it's docs, just that GPs suggestion that it did was different than identifying a problem with the complexity of the software.
- acemarke 7y agoWe're already planning to revamp the docs in the _very_ near future (like, hopefully starting in the next couple weeks once I get Redux Starter Kit 1.0 out the door). See my proposed changes here: https://github.com/reduxjs/redux/issues/3313#issuecomment-450601554 https://github.com/reduxjs/redux/issues/3313#issuecomment-45...