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

[RFC/PATCH 0/5] Make README more pleasant to read

From
Matthieu Moy <matthieu.moy@imag.fr>
Date
Feb 23, 2016, 17:40 UTC
Message-ID
<1456249229-30454-1-git-send-email-Matthieu.Moy@imag.fr>

This patch series was inspired by a discussion I had with Emma Jane after Git Merge last year. It tries both to make the README file less agressive and generally more pleasant to read.

To get a quick overview, compare the old one:
  https://github.com/git/git#readme
and my proposal:
  https://github.com/moy/git/tree/git-readme#readme
Matthieu Moy (5):
  README: use markdown syntax
  README.md: add hyperlinks on filenames
  README.md: move the link to git-scm.com up
  README.md: don't call git stupid in the title
  README.md: move down historical explanation about the name
 README => README.md | 54 ++++++++++++++++++++++++++++-------------------------
 t/t7001-mv.sh       |  2 +-
 2 files changed, 30 insertions(+), 26 deletions(-)
 rename README => README.md (67%)
-- 
2.7.2.334.g35ed2ae.dirty
Next: Matthieu Moy
Message 1 of 25 in “Make README more pleasant to read”
  1. 0/5 Make README more pleasant to readMatthieu Moy, Feb 23, 2016
  2. 1/5 README: use markdown syntaxMatthieu Moy, Feb 23, 2016
  3. Junio C HamanoFeb 23, 2016
  4. Matthieu MoyFeb 23, 2016
  5. Johannes SchindelinFeb 24, 2016
  6. Jeff KingFeb 24, 2016
  7. 2/5 README.md: add hyperlinks on filenamesMatthieu Moy, Feb 23, 2016
  8. Junio C HamanoFeb 23, 2016
  9. Matthieu MoyFeb 23, 2016
  10. 3/5 README.md: move the link to git-scm.com upMatthieu Moy, Feb 23, 2016
  11. 4/5 README.md: don't call git stupid in the titleMatthieu Moy, Feb 23, 2016
  12. Junio C HamanoFeb 23, 2016
  13. Matthieu MoyFeb 23, 2016
  14. Junio C HamanoFeb 23, 2016
  15. 5/5 README.md: move down historical explanation about the nameMatthieu Moy, Feb 23, 2016
  16. Jeff KingFeb 24, 2016
  17. Matthieu MoyFeb 24, 2016
  18. Jeff KingFeb 25, 2016
  19. Junio C HamanoFeb 25, 2016
  20. 0/5 Make README more pleasant to readMatthieu Moy, Feb 25, 2016
  21. 1/5 README: use markdown syntaxMatthieu Moy, Feb 25, 2016
  22. 2/5 README.md: add hyperlinks on filenamesMatthieu Moy, Feb 25, 2016
  23. 3/5 README.md: move the link to git-scm.com upMatthieu Moy, Feb 25, 2016
  24. 4/5 README.md: don't call git stupid in the titleMatthieu Moy, Feb 25, 2016
  25. 5/5 README.md: move down historical explanation about the nameMatthieu Moy, Feb 25, 2016

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.