Date: Sun, 12 Dec 2004 17:10:10 +1100 From: Sam Lawrance <boris@brooknet.com.au> To: doc@freebsd.org Subject: Reorganising the porter's handbook Message-ID: <41BBE0C2.8010603@brooknet.com.au>
next in thread | raw e-mail | index | archive | help
I think the porter's handbook could be reorganised and reworked with great effect. I would like to do this if people think it useful. After Kris Kennaway's request for a "being a port maintainer" document, I looked through the porter's handbook for a while. Have a look at the table of contents - there are 20 or so chapters, some fairly broad like "Ports Security" and some are as narrow as "X11 fonts". I think it would be good to chop this down to maybe 8 or 10 chapters and reorganise things a bit more logically. For example, they might be: - Overview - How to contribute - Creating a new port - Adopting an existing port - Maintaining a port - Recommended practices - Issues when creating and maintaining a port - Ports framework reference The first 7 chapters could contain most of the stuff that most porters will need to know, and the last chapter contains all the stuff that people don't necessarily want to read through but may like to look up at some stage. Is this good? Not so good? Anybody working or thinking similarly? -- Sam Lawrance ph +61 0425 228 579 freenode: deft
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?41BBE0C2.8010603>