Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 11 Oct 2017 13:52:35 -0500
From:      Mark Linimon <linimon@lonesome.com>
To:        Russell Haley <russ.haley@gmail.com>
Cc:        Benjamin Kaduk <bjk@freebsd.org>, koobs@freebsd.org, doc@freebsd.org, freebsd-ports@freebsd.org
Subject:   Re: Porters Handbook section 4.4
Message-ID:  <20171011185235.GA7088@lonesome.com>
In-Reply-To: <CABx9NuTw-_VEPDEwc6TKxsNCO2TuJrNKZfdHBf1wWye2_5Rn4w@mail.gmail.com>
References:  <CABx9NuSC=tVieJ=dk6%2BFucvfEfNGHCRMuHcy%2BNxo9QW%2BtS8-gA@mail.gmail.com> <8a3e663a-d94f-0ef7-bbc7-8ebaa111f6dd@FreeBSD.org> <CABx9NuS6ie6fVwMh68wpRmRE6MsuGDfKQgLdVVZaeL_HJrKVOg@mail.gmail.com> <7b2f2464-5c35-e24a-2047-838c1a9e96a3@FreeBSD.org> <CABx9NuTUmeSU8yYkiYpR2vGYkhTV_MiHuNJYqZvLwJ9Q97B8Zg@mail.gmail.com> <alpine.BSF.2.21.1709290857480.9561@wonkity.com> <CABx9NuQrAsEXAXXmtZePQwn_x0Q7UywA73eggQW1mtDHmFdxxg@mail.gmail.com> <CABx9NuTqYh9A06vgALA6J3fB-_%2BMc5ZvR9Y4RYF7uh_wU4FSPg@mail.gmail.com> <20171009224825.GM96685@kduck.kaduk.org> <CABx9NuTw-_VEPDEwc6TKxsNCO2TuJrNKZfdHBf1wWye2_5Rn4w@mail.gmail.com>

next in thread | previous in thread | raw e-mail | index | archive | help
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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20171011185235.GA7088>