git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] Documentation: Use 'First Paragraph' instead of 'First Line'.

From
Junio C Hamano <gitster@pobox.com>
Date
Sep 13, 2012, 21:30 UTC
Message-ID
<7vmx0t625z.fsf@alter.siamese.dyndns.org>
In-Reply-To
<50524E23.2040507@codeweavers.com>
Jeremy White <jwhite@codeweavers.com> writes:
Show 12 quoted lines
>>> I did not substantially alter this. The emphasis of this section
>>> is on the broader show-branch output, and belaboring the subject would
>>> be distracting and unnecessary imho.
>> 
>> Yeah, but if that is the focus of this part of the documentation,
>> wouldn't a patch to update "the first line" with something more
>> generic like "title of the commit" be more appropriate?
>
> See my patch; I went with 'first part'.  That, I think, does not
> mislead (the goal of my change), but also does not distract from
> the main point of the section (detailing the various bits of
> git show-branch).

For that kind of casual wording, we have used "title" on this list for quite a long time, I think. So I'd rather see a change that just says "title" (if we are making such a change to the documentation, that is). This is not a very strong preference, though.

Previous: Jeremy WhiteNext: Jeremy White
Message 6 of 8 in “Documentation: Use 'First Paragraph' instead of 'First Line'.”
  1. Documentation: Use 'First Paragraph' instead of 'First Line'.Jeremy White, Sep 13, 2012
  2. Junio C HamanoSep 13, 2012
  3. Jeremy WhiteSep 13, 2012
  4. Junio C HamanoSep 13, 2012
  5. Jeremy WhiteSep 13, 2012
  6. Junio C HamanoSep 13, 2012
  7. Jeremy WhiteSep 13, 2012
  8. Philip OakleySep 13, 2012

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.