Subject: Re: Things That Suck About pkgsrc, part 3
To: Hubert Feyrer <firstname.lastname@example.org>
From: Nathan J. Williams <nathanw@MIT.EDU>
Date: 07/13/1998 14:52:37
>> The man pages are fine as a reference, but for the average user, we
>> need something more instructive and tutorial, or they'll never be able
>> to use it.
>Serious Charles, if someone can't live with what's in pkgsrc/README, i
>have little hope for that person anyways.
"Pkgsrc? What's pkgsrc?" I hope you're not proposing the "go
hunting through the filesystem" documentation scheme.
The problem that Charles points out is quite real; even when
we do have documentation for bits of our system, our top-level
documentation that introduces these other things is bad or
nonexistent. INSTALL, for example, introduces man pages and the intro
page, but nothing else.