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

Re: Documentation options: Code or not?

From
Junio C Hamano <gitster@pobox.com>
Date
Jan 5, 2026, 01:54 UTC
Message-ID
<xmqqikdgn7ry.fsf@gitster.g>
In-Reply-To
<2076768.usQuhbGJ8B@debian-mbp>
Michael Lyons <git@michael.lyo.nz> writes:
> I started a quick commit to drop the backticks from rerere-options, but then

The current trend is to mark-up even the individual items in the description list correctly, so if you were to help improve consistency, you need to go the other direction. Look for messages in the list archive by Jean-Noël Avila, who is the primary person driving this effort, for examples. Or picking one of the resulting commits randomly, see f7316a66 (doc: convert git push to synopsis style, 2025-11-19).

Previous: Michael LyonsNext: Jean-Noël Avila
Message 2 of 3 in “Documentation options: Code or not?”
  1. Michael LyonsJan 4, 2026
  2. Junio C HamanoJan 5, 2026
  3. Jean-Noël AvilaJan 5, 2026

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.