2 ms·
One hundred percent. I remember the original react docs were great for teaching the vocabulary, but then it seemed we had to figure out sentences and paragraph
by enobrev 4y ago
One hundred percent.
I remember the original react docs were great for teaching the vocabulary, but then it seemed we had to figure out sentences and paragraphs on our own. To be fair, I started that journey during (or soon after?) the beta. It would be unreasonable to expect more from the docs at that point.
But we definitely need an intermediate and advanced level of documentation for these things:
> Now that you know how to use vars, loop, etc, let's build a [app] from scratch to see how it all works together.
And then...
> Now that you understand how to build [app] from scratch, let's use some advanced techniques to improve the app. Here's why we do this, that, and a third as our app grows.
And it needs to be something more significant than a TODO app. I get the appeal of a TODO app. It's basically the simplest useful form of CRUD. But that simplicity is why it's not the best example beyond introduction.