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 85ADD139694 for ; Fri, 28 Jul 2017 10:38:47 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 4745AE0EA0; Fri, 28 Jul 2017 10:38:41 +0000 (UTC) Received: from mo6-p04-ob.smtp.rzone.de (mo6-p04-ob.smtp.rzone.de [IPv6:2a01:238:20a:202:5304::11]) (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 CD5B1E0E93 for ; Fri, 28 Jul 2017 10:38:40 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; t=1501238318; l=3767; s=domk; d=akhuettel.de; h=Content-Type:MIME-Version:References:In-Reply-To:Date:Subject:To: From; bh=5unil8YNevC8wUIb27bkJpAYXJIAC6JheB3ty3IFkXU=; b=NPpvMDUA68qTGYA1rCqw7fd5Q7IMrV9lgWRzAQbKiCV0cW61sj13XkWAMUxWlTpd+j 2KeQQUNZ1RAw6L191ybSpVv+DS+T895aFe+nfDdfmMpBSEhiPjhi9V3ySxD3vxw7lyT/ i7No5RTLRJFYfx/U19dQe/Lnjid3tcgL6nbVc= X-RZG-CLASS-ID: mo04 X-RZG-AUTH: :IW0NeWCpcPchHrcnS4ebzBgQnKHTmUiSF2JlOcy7/4i/LfK0HEnQHvj8Yvw= Received: from porto.localnet ([118.70.183.132]) by smtp.strato.de (RZmta 41.1 SBL|AUTH) with ESMTPSA id z0443bt6SAcaUo8 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (curve secp521r1 with 521 ECDH bits, eq. 15360 bits RSA)) (Client did not present a certificate) for ; Fri, 28 Jul 2017 12:38:36 +0200 (CEST) From: "Andreas K. Huettel" To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] [RFC pre-GLEP] Gentoo Git Workflow Date: Fri, 28 Jul 2017 12:38:26 +0200 Message-ID: <1596428.S6uqz0IeBJ@porto> Organization: Gentoo Linux In-Reply-To: <1500969906.1206.1.camel@gentoo.org> References: <1500969906.1206.1.camel@gentoo.org> 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 Content-Type: multipart/signed; boundary="nextPart1951589.q4u1HSIxfS"; micalg="pgp-sha512"; protocol="application/pgp-signature" X-Archives-Salt: 88cccca2-8f3c-429f-96a3-31593afa791b X-Archives-Hash: 40079ab83350a46bf82ba61b1415f71c --nextPart1951589.q4u1HSIxfS Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="UTF-8" Am Dienstag, 25. Juli 2017, 10:05:06 CEST schrieb Micha=C5=82 G=C3=B3rny: > 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 pages > 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? TL;DR: I like it; minor comments on the commit message format (surprise). W= e=20 should strive to provide consistent standards for it. > =3D=3D=3DCommit messages=3D=3D=3D [...] > If a bug is associated > with a change, then it should be included in the summary line as > #nnnnnn or likewise.=20 =2E.., for practical reasons in a format that is recognized by willikins.=20 So, please DON'T do "... fixes #234987". I suggest we recommend a plain "... bug 234567 ..." So far, "bug x" in our repository by default refers to the Gentoo bugzilla,= =20 and it makes sense to stick with that. > The tag part is included in the full commit log as an extension to the > body. It consists of one or more lines consisting of key, followed by a > colon and a space, followed by value. Git does not enforce any > standardization of the keys, and the tag format is ''not'' meant for > machine processing. >=20 > A few tags of common use are: [...] > ** Bug: https://bugs.gentoo.org/NNNNNN; =E2= =80=94 to > reference a bug, > ** Closes: https://github.com/gentoo/gentoo/pull/NNNN ki>; =E2=80=94 to automatically close a GitHub pull request, > ** Fixes: https://bugs.gentoo.org/NNNNNN; =E2= =80=94 > to indicate a fixed bug, I would like to suggest that *if* such tags are used, we require that they= =20 should always contain a full URL to an issue tracker or code source. This allows generic referencing of other bug trackers, leaves developers th= e=20 option to auto-handle github-specific things, and still (for the purists)=20 doesn't require mentioning Github in the GLEP. =2D-=20 Andreas K. H=C3=BCttel dilfridge@gentoo.org Gentoo Linux developer (council, perl, libreoffice) --nextPart1951589.q4u1HSIxfS Content-Type: application/pgp-signature; name="signature.asc" Content-Description: This is a digitally signed message part. Content-Transfer-Encoding: 7Bit -----BEGIN PGP SIGNATURE----- iQIzBAABCgAdFiEEJA5qH5IRj7fTL1RCdGtqHaygwr4FAll7FCIACgkQdGtqHayg wr6cPQ/+K+l5p3xkpBfdVlHwZOXblFk7/iq4QjBTu+Jaq5XdsPVYw6PD2oAl0XLF lA+HiXguZq6y2C3eceubbm/DvLPbTlkviTco+P6o+d40LfvElIDX3CfBvNJnOc9C fGjf/fWMX0QWOTbitnMuhormmYYGW1ul0D3SjBgVfq+2sqDdkp6DWM6Vb/W6a9Lu aGwEn/UECo4HADB7SR9ZXoCmOwhGEyw4Nl8tBj02gCm0+T4PoDt6yJTDGW0Kj+ma Hyi361c76FKSNXh+W/1d+GTwt71mK46dlQJfzUqP32+ua0wujq/cuLjFQrLF5b3e 65+rA9FBHkby3jY0ePCeTvlVT4Yq2mJpvVW+0nI+yxQ67P6rE12Etd1oUQg/7WpM UTS5Zh/gBLmFjYa4NI+t/C235RzY4NK1Tql665xY5vCm2AyCaZ6w6ckE2gZR252V 35DI9tR/fd3BpP2oey2VKoeBZK7sg5uzQlY+L9hrvTBeQ6w7y5G/qseal9fifoku q5Fxlh9TB0/Gtpt+vSqA1YLlfJvwB28o5enrjWcg832DtIALFOqAkstpPn6I2Ain YAYdp84aXoh8uR54Afu3O3nV4/BRqf6+YWEKfAj1CfuAtZZPy+q31t790e76rJnT mh6Wq4uoLH7rFzoQMmueXUGW4HxjkFEXZ/pv522DUbwjilcq0XA= =LlRf -----END PGP SIGNATURE----- --nextPart1951589.q4u1HSIxfS--