On Mon, Oct 10, 2016 at 11:24:01AM -0700, Junio C Hamano wrote: > Jeff King <peff@xxxxxxxx> writes: > > > On Fri, Oct 07, 2016 at 11:56:38AM +0200, Heiko Voigt wrote: > > > >> The description for referencing commits looks as if it is contradicting > >> the example, since it is itself enclosed in double quotes. Lets use > >> single quotes around the description and include the double quotes in > >> the description so it matches the example. > >> --- > >> Sorry for opening this up again but I just looked up the format and was > >> like: "Umm, which one is now the correct one..." > >> > >> For this makes more sense. What do others think? > > > > Looking over the threads, I wasn't sure there was consensus[1,2]. So it would > > be equally correct to drop the quotes from the example. > > > > I dunno. I am in favor of no-quotes, myself, so maybe I am just > > manufacturing dissent in my mind. :) > > I no longer have preference either way myself, even though I was in > favor of no-quotes simply because I had an alias to produce that > format and was used to it. I'll admit that I don't care _that_ much and am happy to leave it up to individual authors, as long as nobody quotes SubmittingPatches at me as some kind of gospel when I use the no-quotes form. -Peff