It's true. There's a basically undocumented set of skills that you have to pick up first before the docs are useful. But also you can't pick up the skills, sometimes, without using the docs.
IMO this is one reasom to start with, or just test, a linux distro that has you do a bunch of low-level stuff manually. To install gentoo, you have to use the command line and call the various magical incantations to make the right things happen. Through repetition, and sometimes the documentation, you'll pick up what is happening.
You can always go back to a more automated distro, but you'll have the skills to put out the little fires that pop up here and there.
There's also a course out there somewhere called something like, "the missing semester of cs" that covers a bunch of common nerd skills that mostly applies to linux. Highly recommend it.
The beauty of linux and open source is that you can rewrite the documentation. Doc writers are badly needed because coders hate writing documentation - you'll fit right in.
Anyone can write documentation until they have a question they don't know the answer to. And Linux land is full of stuff people don't have an answer to. There are literally system calls that have no documentation whatsoever. There are probably system calls barely anyone knows exist.
And when u try to read about it, the documentation assumes so much knowledge and familiarity with Linux :'(
It's true. There's a basically undocumented set of skills that you have to pick up first before the docs are useful. But also you can't pick up the skills, sometimes, without using the docs.
IMO this is one reasom to start with, or just test, a linux distro that has you do a bunch of low-level stuff manually. To install gentoo, you have to use the command line and call the various magical incantations to make the right things happen. Through repetition, and sometimes the documentation, you'll pick up what is happening.
You can always go back to a more automated distro, but you'll have the skills to put out the little fires that pop up here and there.
There's also a course out there somewhere called something like, "the missing semester of cs" that covers a bunch of common nerd skills that mostly applies to linux. Highly recommend it.
The beauty of linux and open source is that you can rewrite the documentation. Doc writers are badly needed because coders hate writing documentation - you'll fit right in.
But you have to understand the code to write the documentation...
Writing documentation is literally a job that non-coders can do.
Anyone can write documentation until they have a question they don't know the answer to. And Linux land is full of stuff people don't have an answer to. There are literally system calls that have no documentation whatsoever. There are probably system calls barely anyone knows exist.
Perfect is the enemy of good. Pick up a github project and get to work. Be the change you want to see.
Harder to do if they have no documentation lol.
Perfect is the enemy of good. Pick up a github project and get to work. Be the change you want to see.
Sounds like reddit talking about theory
How does someone with no understanding of the code start documenting the code exactly?