From owner-freebsd-doc Tue Mar 7 2: 8:27 2000 Delivered-To: freebsd-doc@freebsd.org Received: from axl.ops.uunet.co.za (axl.ops.uunet.co.za [196.31.1.175]) by hub.freebsd.org (Postfix) with ESMTP id CFAC837BE74 for ; Tue, 7 Mar 2000 02:08:20 -0800 (PST) (envelope-from sheldonh@axl.ops.uunet.co.za) Received: from sheldonh (helo=axl.ops.uunet.co.za) by axl.ops.uunet.co.za with local-esmtp (Exim 3.13 #1) id 12SGu8-000NpJ-00; Tue, 07 Mar 2000 12:07:52 +0200 From: Sheldon Hearn To: keramida@ceid.upatras.gr Cc: freebsd-doc@FreeBSD.ORG Subject: Re: Commiters guide in -mandoc In-reply-to: Your message of "Tue, 07 Mar 2000 02:10:16 +0200." <20000307021016.C81669@hades.hell.gr> Date: Tue, 07 Mar 2000 12:07:51 +0200 Message-ID: <91592.952423671@axl.ops.uunet.co.za> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, 07 Mar 2000 02:10:16 +0200, Giorgos Keramidas wrote: > I've finished the markup in -mandoc and the entire document can now be > found at Okay, I've had a brief look at this. I think that it is inappropriate to include a manual page for committers in the base system, because so few users are committers. A much more useful contribution (and one more likely to be included) is a contribute.7 . The problem is that you've very definitely targetted committers with this page. It looks like it'd be quite a bit of work turning it into contribute.7 . In all honesty, though, I'm not sure how many people would figure out that they need to ``man contribute''. I think it's much more likely that people are going to look for this sort of information on the web pages. Therefore, this should probably be done as a patch to doc/en_US.ISO_8859-1/books/handbook/contrib/chapter.sgml . Ciao, Sheldon. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message