From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id D09F0139694 for ; Tue, 25 Jul 2017 13:44:08 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 515A41FC057; Tue, 25 Jul 2017 13:43:59 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id ED6281FC007 for ; Tue, 25 Jul 2017 13:43:58 +0000 (UTC) Received: from pomiot (d202-252.icpnet.pl [109.173.202.252]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) (Authenticated sender: mgorny) by smtp.gentoo.org (Postfix) with ESMTPSA id 53E343417D9; Tue, 25 Jul 2017 13:43:57 +0000 (UTC) Message-ID: <1500990233.795.10.camel@gentoo.org> Subject: Re: [gentoo-dev] [RFC pre-GLEP] Gentoo Git Workflow From: =?UTF-8?Q?Micha=C5=82_G=C3=B3rny?= To: gentoo-dev@lists.gentoo.org Date: Tue, 25 Jul 2017 15:43:53 +0200 In-Reply-To: <91ae02b2-199f-d8e0-84a1-790da4fbb86e@gentoo.org> References: <1500969906.1206.1.camel@gentoo.org> <91ae02b2-199f-d8e0-84a1-790da4fbb86e@gentoo.org> Organization: Gentoo Content-Type: multipart/signed; micalg="pgp-sha512"; protocol="application/pgp-signature"; boundary="=-/MsP8lU6fkCy3qQHxs3f" X-Mailer: Evolution 3.22.6 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org Mime-Version: 1.0 X-Archives-Salt: 845217e0-33cb-4d32-810e-8a4c4e9a61b0 X-Archives-Hash: a0026fe418d5b23b3b70c019956df3f9 --=-/MsP8lU6fkCy3qQHxs3f Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On wto, 2017-07-25 at 08:54 -0400, Joshua Kinard wrote: > On 07/25/2017 04:05, Micha=C5=82 G=C3=B3rny wrote: > > Hi, everyone. > >=20 > > There have been multiple attempts at grasping this but none so far > > resulted in something official and indisputable. At the same time, we > > end having to point our users at semi-official guides which change > > in unpredictable ways. > >=20 > > Here's the current draft: > > https://wiki.gentoo.org/wiki/User:MGorny/GLEP:Git > >=20 > > The basic idea is that the GLEP provides basic guidelines for using git= , > > and then we write a proper manual on top of it (right now, all the page= s > > about it end up as a mix of requirements and a partial git manual). > >=20 > > What do you think about it? Is there anything else that needs being > > covered? > >=20 > > Copy of the markup for inline comments follows. >=20 > I haven't seen it mentioned yet, but will this GLEP update or replace thi= s > existing Wiki article on using git w/ Gentoo?: >=20 > https://wiki.gentoo.org/wiki/Gentoo_git_workflow We will probably remove it in favor of a proper devmanual section. Proxy-maint already stopped using it because there's too much noise there. > Some of the step-by-step bits in the above Wiki page look like good candi= dates > to be integrated into the GLEP. Could you be more specific? > It also contains guidelines on writing commit > messages, such as limiting the first line to ~50 characters, an optional = body > wrapped at 75 chars/line, and including the usual git tags for sign-off a= nd > such. Though, I like the explicitness of the GLEP's text on a few things= more. There is a large section on commit messages in the GLEP. Though it uses 69 as the technical limit of summary line, since ~50 is realistically hard to achieve for Gentoo. --=20 Best regards, Micha=C5=82 G=C3=B3rny --=-/MsP8lU6fkCy3qQHxs3f Content-Type: application/pgp-signature; name="signature.asc" Content-Description: This is a digitally signed message part Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- iQKmBAABCgCQFiEEbbsHzE8NrQbqCv5BsHoa6u+0Rk4FAll3SxlfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDZE QkIwN0NDNEYwREFEMDZFQTBBRkU0MUIwN0ExQUVBRUZCNDQ2NEUSHG1nb3JueUBn ZW50b28ub3JnAAoJELB6GurvtEZO5vIQANG6vo7cxdBICq6uG75nDmn2Un4wttlP oXiiVUqyza/FVF9Fe0Kd8aS/+jJhe5AjC0+tO4tBnBJsRZtYqmi1Tx2e+CmdsW3/ 8D3VVwgTf/yCToKOcO+b/FOtNh/cB7VJ3qRFaWohjUw9z4s/Gem1XjgFyqeICp2S uUSmgFN/z+Uj6PxXsWKXnZS+thfzBZUcRNGa88MHSVQcnhX8ncEhRSvdj17JTKEW cuNUTLqkraivhTSnyV2qZqCuzaAXhiVndyzmvr3OydruXJQwq+5Z7VRoey+jOlh/ f7E3NNcUiHibk1ED9AA2pmssXInb90M/YkIJmOueCvu2WBVys94GSvS7W4MlW4ws 8WQixtQvxb8tppMRt0108BTgESy9YD9L6HKxIGU9lOz1IrtNsbyWFBwzxd2T+ODa BdVrVV8SLUsrNEUgy5rnkFyb/V9sTENKFjvayJaxaQRlke51qkyO16mrEzKTbXfM 2zGsqAdiWQW2NeU6yN0HLniXJF+PFk83NywNN2FN1w5rUQg4JXdPqBQ7zTMHHsVt vvmcpV6Cdq6ShbTX9nNECBVYOJ8FThBUX5FepO+FPV8TLl6/56Xz6NWrAwUMvgYC TvAeyQ3rHI5bJfOIqkiHA8re2eb+H6iCHgvxBsSnhEGfX2g9F6BDPKniveGOnitB KbKLZN0t4XOD =KBdx -----END PGP SIGNATURE----- --=-/MsP8lU6fkCy3qQHxs3f--