• early_riser@lemmy.world
    link
    fedilink
    arrow-up
    2
    ·
    edit-2
    2 hours ago

    The ability to write clear documentation is an invaluable skill. So many open source projects have terrible docs. The docs are probably written by the devs themselves, who perhaps don’t realize that end users won’t have the intimate knowledge of the thing they’re documenting as they do, so they leave a lot unsaid that should really be explicit.

    In IT, at least in networking, systems quickly become black boxes even to the person that designed it, and good docs are just as useful to the person writing them.