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

Re: [PATCH] Documentation/git-commit: rewrite to make it more end-user friendly.

From
Junio C Hamano <junkio@cox.net>
Date
Dec 10, 2006, 23:05 UTC
Message-ID
<7vfybn2vyw.fsf@assigned-by-dhcp.cox.net>
In-Reply-To
<Pine.LNX.4.64.0612101704390.2630@xanadu.home>
Nicolas Pitre <nico@cam.org> writes:
Show 6 quoted lines
>> Man pages are reference documentation, so I figure it's OK to sacrifice
>> a little newbie-friendliness for accuracy and concision.
>
> I disagree.  Clarity should be the first goal.  And the fact that even 
> modified files have to be specified is something worth enphasizing, 
> especially since this is not something other systems do.

Let's keep plumbing documentation technical reference material, but allow more newbie friendliness in Porcelain-ish documentation.

Previous: J. Bruce FieldsNext: Alan Chandler
Message 23 of 25 in “Documentation/git-commit.txt”
  1. Junio C HamanoDec 8, 2006
  2. Salikh ZakirovDec 8, 2006
  3. Junio C HamanoDec 8, 2006
  4. Nicolas PitreDec 8, 2006
  5. Alan ChandlerDec 8, 2006
  6. Nicolas PitreDec 9, 2006
  7. Junio C HamanoDec 9, 2006
  8. J. Bruce FieldsDec 9, 2006
  9. Nicolas PitreDec 9, 2006
  10. Jakub NarebskiDec 9, 2006
  11. Documentation/git-commit: rewrite to make it more end-user friendly.Junio C Hamano, Dec 9, 2006
  12. Nicolas PitreDec 9, 2006
  13. Junio C HamanoDec 9, 2006
  14. Jakub NarebskiDec 9, 2006
  15. Linus TorvaldsDec 9, 2006
  16. Jakub NarebskiDec 9, 2006
  17. Nicolas PitreDec 9, 2006
  18. Josef WeidendorferDec 10, 2006
  19. Nicolas PitreDec 10, 2006
  20. J. Bruce FieldsDec 10, 2006
  21. Nicolas PitreDec 10, 2006
  22. J. Bruce FieldsDec 10, 2006
  23. Junio C HamanoDec 10, 2006
  24. Alan ChandlerDec 10, 2006
  25. J. Bruce FieldsDec 9, 2006

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.