From owner-freebsd-doc@FreeBSD.ORG Sun Mar 13 01:54:23 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from hub.freebsd.org (hub.freebsd.org [IPv6:2001:4f8:fff6::36]) by hub.freebsd.org (Postfix) with ESMTP id 458CB106566C; Sun, 13 Mar 2011 01:54:23 +0000 (UTC) (envelope-from tabthorpe@freebsd.org) Date: Sat, 12 Mar 2011 20:54:22 -0500 From: Thomas Abthorpe To: Chris Rees Message-ID: <20110313015422.GR49936@hub.freebsd.org> References: <20101130150839.GH52404@hub.freebsd.org> <20110305165057.GD56261@hub.freebsd.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="phbq2bkSb+hZnunM" Content-Disposition: inline In-Reply-To: X-URL: http://www.goodking.org/ X-PGP-Key: http://people.freebsd.org/~tabthorpe/tabthorpe.asc X-PGP-Key-ID: 0xA473C990 X-PGP-Key-Fingerprint: D883 2D7C EB78 944A 69FC 36A6 D937 1097 A473 C990 User-Agent: Mutt/1.5.21 (2010-09-15) Cc: freebsd-doc@freebsd.org, portmgr@freebsd.org Subject: Re: Things all ports mentors and potential mentees should know X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 13 Mar 2011 01:54:24 -0000 --phbq2bkSb+hZnunM Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sat, Mar 12, 2011 at 07:06:20PM +0000, Chris Rees wrote: > On 5 March 2011 16:50, Thomas Abthorpe wrote: > > On Sat, Mar 05, 2011 at 01:48:40PM +0000, Chris Rees wrote: > >> On 30 November 2010 15:08, Thomas Abthorpe wro= te: > >> > Greetings list > >> > > >> > This document was initially prepared by portmgr@ as a means of > >> > addressing issues around ports quality, in addition to informing > >> > mentors/mentees their duties and obligations within the ports tree. > >> > > >> > It has gone through some peer review among ports committers, integra= ting > >> > feedback from the community at large. =A0This is intended as a livin= g, > >> > growing document to be updated and modified over time. =A0At some po= int > >> > in the future, it will likely get rendered for use on the WWW, in the > >> > meantime it is being tracked as a text file. > >> > > >> > Without further delay, I would like to present Mentoring Guidelines, > >> > feedback welcome! > >> > > >> > >> > >> > >> Hi, > >> > >> I was thinking of volunteering to render this in SGML to go > >> into the Committer's Guide... perhaps at the bottom of [1]? > >> > >> Is anyone working on this, or should I get started? > >> > >> Chris > >> > >> [1] http://www.freebsd.org/doc/en_US.ISO8859-1/articles/committers-gui= de/conventions.html > >> > > > > Hi Chris > > > > Thank you for your generous offer! =A0This is something on my long term > > todo list, and is not yet on the radar, so if you want to sgmlise the > > mentor guidelines, I would greatly welcome! > > > > Do your bit to render the doc, and I can work with you and maybe a doc > > committer to get it in. > > > > > > Thomas >=20 > Hi all, >=20 > I've just finished rendering the mentor/mentee guidelines; I've stuck > it in (for want of a better place) the Committer's Guide. >=20 > The source for my changes is: >=20 > http://www.bayofrum.net/~crees/patches/mentor_mentee_guidelines.diff >=20 > It's rendered here: >=20 > http://www.bayofrum.net/~crees/comm.html#MENTOR.GUIDELINES >=20 > Does anyone have any comments so far? I like the general flow, as it does follow along with the original. I minor nit I have to offer is inconsistent use of the mailto:porgmgr@FreeBSD.org tag. I would just use portmgr across the board. >=20 > Chris >=20 > PS Hope you're proud of me for learning how to format SGML the 'proper > way'; I may go back and fix the Tinderbox docs too to make them less > offensive when I have time... >=20 Good job on learning the SGML stuff, it is reasonably easy, and the FDP guidelines are reasonably well documented. If you have aspirations for various purposes, submit this as a PR, else just say so, and I/we will do our part. Thomas --=20 Thomas Abthorpe | FreeBSD Committer tabthorpe@FreeBSD.org | http://people.freebsd.org/~tabthorpe --phbq2bkSb+hZnunM Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.17 (FreeBSD) iQEcBAEBAgAGBQJNfCPOAAoJENk3EJekc8mQKAkIAIYuB/jzOPXs0GtQH+W+8kgK L6DSbzJw9wJDf9LuHzRvyVLOPN4wmLhTVEt99owVx9n/ci9yqXKABswNOxDBAwsn kbpe1hTXmU3PCrkL0IZt81Dsn+ZcubOouReBnjjlgU0DDnlNxuQnSIsQBaKSTr9h sjQfzCaZjUAaba+F3JI4rC5urEVpxmu/3vUUZiW0xChHijIk39Eh7+hyXm2FKLxG W2p57sE2Yc1krkBTVZJ37vrH82gWfSdZHt0fhkAqS3uxSR0pp+a63mJEdL5rRkzO 6o9LKpQ6rwCuK/CxDsLRUhlMvtYWPvit2XQlNEwsFSYqhG/aRbdncj/tcaKDJhs= =Khmv -----END PGP SIGNATURE----- --phbq2bkSb+hZnunM--