From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stephen Leake Newsgroups: gmane.emacs.devel Subject: Re: Your commit 7409a79 Date: Sun, 07 Dec 2014 16:39:13 -0600 Message-ID: <85tx17dqzy.fsf@stephe-leake.org> References: <83h9x917il.fsf@gnu.org> <85k324h0hg.fsf@stephe-leake.org> <83k324yv44.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1417991977 12804 80.91.229.3 (7 Dec 2014 22:39:37 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 7 Dec 2014 22:39:37 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Dec 07 23:39:32 2014 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1XxkUF-0000jm-SX for ged-emacs-devel@m.gmane.org; Sun, 07 Dec 2014 23:39:32 +0100 Original-Received: from localhost ([::1]:59426 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxkUE-0005HS-Uw for ged-emacs-devel@m.gmane.org; Sun, 07 Dec 2014 17:39:30 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51915) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxkU6-0005GT-Oq for emacs-devel@gnu.org; Sun, 07 Dec 2014 17:39:28 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XxkU1-00086w-D4 for emacs-devel@gnu.org; Sun, 07 Dec 2014 17:39:22 -0500 Original-Received: from dnvrco-outbound-snat.email.rr.com ([107.14.73.232]:13688 helo=dnvrco-oedge-vip.email.rr.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxkU1-00086r-5T for emacs-devel@gnu.org; Sun, 07 Dec 2014 17:39:17 -0500 Original-Received: from [70.94.38.149] ([70.94.38.149:53434] helo=TAKVER) by dnvrco-oedge03 (envelope-from ) (ecelerity 3.5.0.35861 r(Momo-dev:tip)) with ESMTP id C4/89-16169-317D4845; Sun, 07 Dec 2014 22:39:16 +0000 In-Reply-To: <83k324yv44.fsf@gnu.org> (Eli Zaretskii's message of "Sun, 07 Dec 2014 05:52:27 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.94 (windows-nt) X-RR-Connecting-IP: 107.14.64.142:25 X-Authority-Analysis: v=2.1 cv=W762VHmk c=1 sm=1 tr=0 a=AppmJ/7ZOOFWL/q6u6u93g==:117 a=AppmJ/7ZOOFWL/q6u6u93g==:17 a=ayC55rCoAAAA:8 a=fNEgcOh0sVsA:10 a=9i_RQKNPAAAA:8 a=mDV3o1hIAAAA:8 a=BhM828Yb8w9atQzPBlQA:9 a=lLcIXvqhIe8A:10 X-Cloudmark-Score: 0 X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 107.14.73.232 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:179321 Archived-At: Eli Zaretskii writes: >> From: Stephen Leake >> Date: Sat, 06 Dec 2014 16:33:47 -0600 >> >> Eli Zaretskii writes: >> >> > commit 7409a79b1b2acf1229dd763f5eb7b96abc17113a >> > Author: Stephen Leake >> > Date: Fri Dec 5 13:13:55 2014 -0600 >> > >> > preparing for further changes/cleanup to developers/contributors docs >> > >> > * etc/CONTRIBUTE: renamed to ./CONTRIBUTE, >> > >> > Please always start the commit log summary line with a capital letter, >> > and end the sentence with a period. >> >> Do we really need to be so picky? > > It's just a good style. > >> Note that the Gnu coding standard does _not_ discuss this level of >> detail, although all the examples do have capitals and periods >> (http://www.gnu.org/prep/standards/html_node/Change-Logs.html#Change-Logs). > > Exactly. Also, all the other entries in Emacs's own logs. Ok, I'm arguing for changing a long-standing practice; that requires a good reason. >> I see this pickiness as a mild barrier to contributing > > I don't think it is. I made a statement of fact about myself. I intended to imply that there could easily be others that feel the same. Your statement, taken literally, says I am wrong about what I feel; absurd, and not helpful. Instead, I will take it to mean, "I (Eli) don't feel that way". That's fine. Still not helpful. > Writing correct English is a basic requirement, > it doesn't even have to be in the document. Like correct spelling, > for example. Correct spelling of computer language symbols is required because compilers/interpreters are very picky. Correct spelling in general is certainly less annoying to read. Incorrect punctuation is much less annoying than incorrect spelling (to me, at least. Apparently not to you). To go to one extreme; non-English speakers will have a much harder time than I of getting all of this right. In light of the general discussion about the high barriers to becoming an Emacs contributor, I'm suggesting we seriously consider lowering this one. Stefan said "we should not worry about this", but I'm not clear how much lack of proper English punctiation he's agreeing to. Since there is some disagreement about this issue among current developers, I will adopt the following interpretation of the rules as written: Developers are strongly encouraged to use fully proper English, but not doing so is not a reason to reject commits, nor to be chastised/gently reminded on the emacs-devel mailing list, unless the deviation actually causes misunderstanding. If you disagree with the above, please edit ./CONTRIBUTE to say what you want more clearly. Include a rationale, so we don't cycle on this endlessly. >> > (Actually, in the above >> > particular case the summary line is redundant and could be omitted -- >> > but this is a stylistic comment, not a requirement.) >> >> I tried that: >> >> * etc/CONTRIBUTE: renamed to ./CONTRIBUTE, preparing for further >> changes/cleanup to developers/contributors docs > > The "preparing for" part doesn't need to be there, it has exactly zero > importance in the context of a commit log. > >> I didn't want to just do: >> >> * etc/CONTRIBUTE: renamed to ./CONTRIBUTE >> >> since that doesn't say anything about _why_. > > You don't need to say why. Ah. Here we have a fundamental misunderstanding/disagreement of what commit logs are for. The classic example in this case is two developers that have different visions about what needs to be done, and keep undoing each other's changes (in this case, moving CONTRIBUTE back to etc). If there is no documentation of _why_, there is no way to resolve that cycle. > You could also point to the list discussion, if you really think > people will need to know why you moved the file. That would be better; I'm not used to having a permanent archive around to reference. > You could push all the changes to the > file, including its move, as a single commit, or a merge-commit with a > single explanatory line. In general, keeping related changes together > requires less explanations. I didn't do that because git does not track renames explicitly; it relies on a % changed heuristic. Since I was planning to make extensive changes, I decided to make separate commits to help the heuristic. This should go in CONTRIBUTE, now that I think about it (and if it's not a problem in practice, that should be stated as well, so others don't make my mistake). Now I realize the commit message should have been: http:/; no other changes to help the git rename heuristic Still longer than 79 chars; I'm going to hit that limit a lot (note that I am _not_ begging to change it; one fight at a time :). -- -- Stephe