Web lists-archives.com

Re: Debian glossary?




Hello,

On Mon, Apr 30, 2018 at 06:46:01AM -0500, Richard Owlett wrote:
> Man pages by their nature/purpose assume a certain level of expertise.
> They can be daunting for the uninitiated.
> 
> Comments?

https://www.greenend.org.uk/rjk/misc/nipple.html :
    The only "intuitive" interface is the nipple. After that it's
    all learned.

If learning about this stuff wasn't difficult, quite a few of us
would be out of a job. Something that's even harder than attaining
the knowledge is writing good documentation about the knowledge.
Something that's nearly impossible is writing good documentation
that meets the needs of readers with every level of expertise,
including "none".

The learning also never ends. Even if you get to the point of having
all your computers doing exactly what you want with software that
hasn't changed in a decade, someone comes along and invents a new
init system, or finds out that all CPUs made in the last 20 years
are insecure, or something.

So, get used to it, I guess? ;)

Cheers,
Andy