MacPorts Docs Strategy - Proposal

[Ryan Schmidt]

On Sep 7, 2007, at 15:25, markd at macports.org wrote:

> The work on the new guide is progressing steadily, but one thing has
> become apparent.  We need to unify our documentation efforts.  The
> manpages proceed on a separate path from the guide docs, and we on  
> the doc
> team (Maun Suang , Simon Ruderich, and I) think that the man pages  
> should
> be rewriten in DocBook and then xincluded into the guide reference
> section, thereby unifying the guide with the manpages.  Simon has  
> tested
> this method of inclusion to hte new guide and it works.

[snip]

I have also been concerned about the many various places MacPorts  
documentation seems to live, and am in favor of consolidating as much  
as possible.