From owner-cvs-doc@FreeBSD.ORG Wed Jun 9 14:47:21 2010 Return-Path: Delivered-To: cvs-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 21FF7106568F; Wed, 9 Jun 2010 14:47:21 +0000 (UTC) (envelope-from gavin@FreeBSD.org) Received: from mail-gw0.york.ac.uk (mail-gw0.york.ac.uk [144.32.128.245]) by mx1.freebsd.org (Postfix) with ESMTP id 9C4578FC12; Wed, 9 Jun 2010 14:47:20 +0000 (UTC) Received: from mail-gw6.york.ac.uk (mail-gw6.york.ac.uk [144.32.129.26]) by mail-gw0.york.ac.uk (8.13.6/8.13.6) with ESMTP id o59ElHJ5017789; Wed, 9 Jun 2010 15:47:17 +0100 (BST) Received: from buffy-128.york.ac.uk ([144.32.128.160] helo=buffy.york.ac.uk) by mail-gw6.york.ac.uk with esmtps (TLSv1:AES256-SHA:256) (Exim 4.68) (envelope-from ) id 1OMMYn-0001RC-OM; Wed, 09 Jun 2010 15:47:17 +0100 Received: from buffy.york.ac.uk (localhost [127.0.0.1]) by buffy.york.ac.uk (8.14.3/8.14.3) with ESMTP id o59ElHOP012366; Wed, 9 Jun 2010 15:47:17 +0100 (BST) (envelope-from gavin@FreeBSD.org) Received: (from ga9@localhost) by buffy.york.ac.uk (8.14.3/8.14.3/Submit) id o59ElHcm012365; Wed, 9 Jun 2010 15:47:17 +0100 (BST) (envelope-from gavin@FreeBSD.org) X-Authentication-Warning: buffy.york.ac.uk: ga9 set sender to gavin@FreeBSD.org using -f From: Gavin Atkinson To: Ulrich =?ISO-8859-1?Q?Sp=F6rlein?= In-Reply-To: <20100609105300.GN39829@acme.spoerlein.net> References: <201006041730.o54HUlnc016635@repoman.freebsd.org> <4C093F30.6050103@FreeBSD.org> <20100609105300.GN39829@acme.spoerlein.net> Content-Type: text/plain; charset="ISO-8859-1" Content-Transfer-Encoding: quoted-printable Date: Wed, 09 Jun 2010 15:47:16 +0100 Message-ID: <1276094836.11123.258.camel@buffy.york.ac.uk> Mime-Version: 1.0 X-Mailer: Evolution 2.28.1 FreeBSD GNOME Team Port X-York-MailScanner: Found to be clean X-York-MailScanner-From: gavin@freebsd.org Cc: Matthew D Fleming , Doug Barton , cvs-doc@FreeBSD.org, cvs-all@FreeBSD.org, zml@FreeBSD.org, doc-committers@FreeBSD.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/share/sgml authors.ent X-BeenThere: cvs-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the doc and www trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 09 Jun 2010 14:47:21 -0000 On Wed, 2010-06-09 at 12:53 +0200, Ulrich Sp=F6rlein wrote: > On Fri, 04.06.2010 at 11:00:16 -0700, Doug Barton wrote: > > On 06/04/10 10:30, Matthew D Fleming wrote: > > > mdf 2010-06-04 17:30:47 UTC > > > > > > FreeBSD doc repository (src committer) > > > > > > Modified files: > > > en_US.ISO8859-1/share/sgml authors.ent > > > Log: > > > Add myself to the list of committers. > > > > > > Revision Changes Path > > > 1.509 +2 -0 doc/en_US.ISO8859-1/share/sgml/authors.ent > > > > > > http://www.FreeBSD.org/cgi/cvsweb.cgi/doc/en_US.ISO8859-1/share/sgml/= authors.ent.diff?&r1=3D1.508&r2=3D1.509&f=3Dh > >=20 > > Matthew, > >=20 > > Couple of things ... first, welcome to the fun! Second, (and your mento= r=20 > > really should be filling you in on this stuff) it's customary for=20 > > related commits in the same tree to go in together. So rather than=20 > > committing these doc updates one at a time it would have been better to= =20 > > get all the related stuff in one go. Also, until you're released from=20 > > mentorship ALL of your commits should indicate that they were approved=20 > > by your mentor (which implies of course that zml reviews them first). >=20 > The handbook is somewhat misleading in this regard, as it warns you that > the www build may break if stuff happens in the wrong order. People may > therefore opt to err on the side of caution by putting stuff in > sequentially. Indeed the handbook actually goes one step further than that: It (implicitly) suggests that these files should be committed to one at a time, as the steps jump from repo to repo and back: if you follow the instructions in order you end up committing to the doc repo, then www, then doc, www, doc, src, ports, and finally src. If it is now preferred that they should all be committed in one go then maybe the committers-guide should be updated. Gavin