Porters Handbook section 4.4

Mark Linimon linimon at lonesome.com
Wed Oct 11 18:52:39 UTC 2017


I had not commented before because I am on a long road trip.

But I'm very glad you have taken on this work.  I had always wanted to
do something very much like this but never made the time to do it.

My old thought was that we have conflated "User's Guide to Ports" and
"Ports Reference Handbook".  Certainly the bulk of the existing text is
the latter type (even if not well organized; it kind of "grew".)

I'm indifferent if the Guide parts (basically what you have been working
on) remain in the PH or become a separate piece.  But depending on the
degree of rewrite, do you think that might be easier?  It's certainly
true that the current PH is too bloated.

I won't have the cycles to look at your work for another week or two,
so consider this just "a voice from the peanut gallery".

mcl


More information about the freebsd-doc mailing list