Hacker News new | ask | show | jobs
by tvanantwerp 2243 days ago
The React docs are excellent. But many (if not most) other projects have woefully under-developed docs that offer confusion more than clarity. I wouldn't blame anyone for assuming that the docs are not the place to start for learning something new.
2 comments

Nowadays if you face a tool with sparse official documentation or with total absence of it, it's probably better to find another tool or be prepared to learn from the source code.
Exactly. That’s one of the heuristic I use nowadays to filter things.

Does it have a good documentation?

Yes? Cool. I dive in head first.

No? Hard pass.

For me React docs look really great, but I don't get a lot from them, even though I'd say I understand JS. OTOH Python docs usually look like crap, but I get a sense of understanding.
That has a lot to do with the underlying language actually. This is purely anecdotal but react was the first framework I tried to learn. It was hard for many reasons. One Angular internship and one big vue project later, it was no longer hard. Everything just fell in place. It just clicked. The secret? My JS skills got way better.
Makes sense. It's probably my love/hate relationship with JS.