Proposed addition to the handbook http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html

[Josh Paetzel]

On Wednesday 21 September 2005 21:03, Giorgos Keramidas wrote:
> On 2005-09-21 19:22, Mark Linimon <linimon at lonesome.com> 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

I will start on the document, perhaps as it evolves it will be clearer 
as to where to put it.

-- 
Thanks,

Josh Paetzel