6
submitted 7 months ago by pseudo@jlai.lu to c/opensource@programming.dev

Hey!

I not good at understanding a project from its code. So, I try as much as I can to understand it from its technical documentation first. But so many time I fell overwhelm by the information: I don't know were to start to read and I don't know how to find a specific information.

How can I know when I'm lacking in understanding the project and when the project is lacking good documentation?
Where should I start while studying a documentation which readme doesn't say "read this next"?

Thank you

you are viewing a single comment's thread
view the rest of the comments
[-] towerful@programming.dev 4 points 7 months ago

Poor documentation is when i find myself reading unit tests to figure out how to use something.
At least there are unit tests...
Bad documentation is when i am digging through source code.

this post was submitted on 03 Apr 2024
6 points (80.0% liked)

Opensource

1444 readers
94 users here now

A community for discussion about open source software! Ask questions, share knowledge, share news, or post interesting stuff related to it!

CreditsIcon base by Lorc under CC BY 3.0 with modifications to add a gradient



founded 1 year ago
MODERATORS