• bluewing@lemm.ee
    link
    fedilink
    arrow-up
    3
    ·
    6 months ago

    There is a lot of merit in reading man pages - as long as you understand what they are talking about. Something most newcomers lack. I’ve read more than one man page that was so poorly written that unless you were a top developer, I was worse off than before I started.

    Technical writing is an art form and very few in the FOSS world, (and even the rest of the world), are really good at it. It always pays to be mindful of just how unskilled your audience is.