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

Re: [PATCH 2/2] Add Author and Documentation sections to git-for-each-ref.txt

From
Jeff King <peff@peff.net>
Date
Mar 10, 2011, 22:37 UTC
Message-ID
<20110310223732.GE15828@sigill.intra.peff.net>
In-Reply-To
<7voc5k9hfy.fsf@alter.siamese.dyndns.org>
On Wed, Mar 09, 2011 at 12:17:53PM -0800, Junio C Hamano wrote:
Show 6 quoted lines
> As the project and the community grew, and also as the internal machinery
> infrastructure got more modularized, I think ownership at the individual
> command level has become almost meaningless concept.
> 
> Same reasoning applies to the "Documented by".  I think it's time for
> these two sections to go from most (if not all) pages.

Yeah, I would just as soon drop Author and Documented-by fields in all manpages. We could replace them with a single "Credits" in git(1). It can either mention nobody, very few people (like Linus as the originator and Junio as the long-time maintainer), or the top N (for N < 20 or so) people in shortlog. And then mention that you can run shortlog yourself.

I would probably do something like this:
diff --git a/Documentation/git.txt b/Documentation/git.txt
index 0c32d45..4323843 100644
--- a/Documentation/git.txt
+++ b/Documentation/git.txt
@@ -745,16 +745,10 @@ unmerged version of a file when a merge is in progress.
 
 Authors
 -------
-* git's founding father is Linus Torvalds <torvalds@osdl.org>.
-* The current git nurse is Junio C Hamano <gitster@pobox.com>.
-* The git potty was written by Andreas Ericsson <ae@op5.se>.
-* General upbringing is handled by the git-list <git@vger.kernel.org>.
-
-Documentation
---------------
-The documentation for git suite was started by David Greaves
-<david@dgreaves.com>, and later enhanced greatly by the
-contributors on the git-list <git@vger.kernel.org>.
+Git was started by Linus Torvalds, and is currently maintained by Junio
+C Hamano. Numerous contributions have come from the git mailing list
+<git@vger.kernel.org>. For a complete list of contributors, see
+linkgit:git-shortlog[1] and linkgit:git-blame[1].
 
 Reporting Bugs
 --------------

And then a follow-on patch to drop the Authors section from all of the
other pages.

-Peff
Previous: Junio C HamanoNext: Junio C Hamano
Message 13 of 24 in “A couple of tweaks in git-for-each-ref.txt”
  1. 0/2 A couple of tweaks in git-for-each-ref.txtAlexei Sholik, Mar 8, 2011
  2. 1/2 Documentation: remove redundant colons in git-for-each-ref.txtAlexei Sholik, Mar 8, 2011
  3. Michael J GruberMar 9, 2011
  4. 2/2 Add Author and Documentation sections to git-for-each-ref.txtAlexei Sholik, Mar 8, 2011
  5. Michael J GruberMar 9, 2011
  6. Alexei SholikMar 9, 2011
  7. Will PalmerMar 17, 2011
  8. Jeff KingMar 17, 2011
  9. Alexei SholikMar 17, 2011
  10. Jeff KingMar 17, 2011
  11. Alexei SholikMar 17, 2011
  12. Junio C HamanoMar 9, 2011
  13. Jeff KingMar 10, 2011
  14. Junio C HamanoMar 10, 2011
  15. Jeff KingMar 11, 2011
  16. Junio C HamanoMar 11, 2011
  17. Alexei SholikMar 12, 2011
  18. Jeff KingMar 13, 2011
  19. Junio C HamanoMar 13, 2011
  20. Jeff KingMar 13, 2011
  21. Junio C HamanoMar 13, 2011
  22. Michael J GruberMar 13, 2011
  23. Jeff KingMar 17, 2011
  24. Junio C HamanoMar 9, 2011

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.