Re: Proposed addition to the handbook

On 2005-09-21 19:22, Mark Linimon <[e-mail]> wrote:
>On Wed, Sep 21, 2005 at 03:04:46PM -0500, Josh Paetzel wrote:
>> Another question would be if this would go beyond the 'basic
>> instructions' statement at the top of the page.
>
> There is a lot of information that is IMHO missing on the various
> strategies to keep up with and use the Ports Collection (portupgrade,
> cvsup, and portsnap all deserve their own sections).  There is a
> little bit at the end of the Porter's Handbook but IMHO the PH is too
> large anyways, and ought to be reoriented into just something targeted
> at maintainers.
>
> What do people think: should this information be in some kind of
> expanded section in the Handbook?  Or a separate Article?

I'm always in favor of splitting the documentation to at least three
types of documents:

	- Administrator documentation
	- End-user documentation
	- Developer documentation

So, I'm in favor of keeping this out of the Porter's Handbook, which
should orbit ever closer to the third type (developer docs).

- Giorgos

_______________________________________________
[e-mail] mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "[e-mail]"