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 6F116139694 for ; Tue, 25 Jul 2017 12:55:11 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 8A879E0D97; Tue, 25 Jul 2017 12:55:01 +0000 (UTC) Received: from resqmta-ch2-08v.sys.comcast.net (resqmta-ch2-08v.sys.comcast.net [IPv6:2001:558:fe21:29:69:252:207:40]) (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 48C14E0C5C for ; Tue, 25 Jul 2017 12:55:01 +0000 (UTC) Received: from resomta-ch2-15v.sys.comcast.net ([69.252.207.111]) by resqmta-ch2-08v.sys.comcast.net with ESMTP id ZzMOd3TM94K9nZzMadtqnT; Tue, 25 Jul 2017 12:55:00 +0000 Received: from [192.168.1.13] ([73.201.189.102]) by resomta-ch2-15v.sys.comcast.net with SMTP id ZzMZdGIYKkdHLZzMadQMQQ; Tue, 25 Jul 2017 12:55:00 +0000 Subject: Re: [gentoo-dev] [RFC pre-GLEP] Gentoo Git Workflow To: gentoo-dev@lists.gentoo.org References: <1500969906.1206.1.camel@gentoo.org> From: Joshua Kinard Message-ID: <91ae02b2-199f-d8e0-84a1-790da4fbb86e@gentoo.org> Date: Tue, 25 Jul 2017 08:54:51 -0400 User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.2.1 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 In-Reply-To: <1500969906.1206.1.camel@gentoo.org> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 8bit X-CMAE-Envelope: MS4wfG052o69XjcCPCnx+4F1D99xuCNMnCCkekMShSmeRms0TPWtEUfsvMMdzLscI/L3PtyQ9ohPJiTK5xq/NPLj9gAqWI2yIA4l5fQXgY9jc1whB17+5V3/ 2fAngRZIdNdJnDvRvPUJvpa3BfLzyGWYZ7PsWOXlc42BpdoGPB9Xnnd8yRQj0niPP07AVshg4Zbh9w== X-Archives-Salt: b12faf41-b7cc-4766-94db-ce0f0dad0853 X-Archives-Hash: 0014f746bc422fd2e64c268fb5f85380 On 07/25/2017 04:05, Michał Górny wrote: > Hi, everyone. > > 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. > > Here's the current draft: > https://wiki.gentoo.org/wiki/User:MGorny/GLEP:Git > > 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). > > What do you think about it? Is there anything else that needs being > covered? > > Copy of the markup for inline comments follows. I haven't seen it mentioned yet, but will this GLEP update or replace this existing Wiki article on using git w/ Gentoo?: https://wiki.gentoo.org/wiki/Gentoo_git_workflow Some of the step-by-step bits in the above Wiki page look like good candidates to be integrated into the GLEP. 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 and such. Though, I like the explicitness of the GLEP's text on a few things more. -- Joshua Kinard Gentoo/MIPS kumba@gentoo.org 6144R/F5C6C943 2015-04-27 177C 1972 1FB8 F254 BAD0 3E72 5C63 F4E3 F5C6 C943 "The past tempts us, the present confuses us, the future frightens us. And our lives slip away, moment by moment, lost in that vast, terrible in-between." --Emperor Turhan, Centauri Republic