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 _______________________________________________ freebsd-doc@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"