Re: [PATCH v3 0/3] doc: introducing synopsis para

From: Junio C Hamano <gitster@pobox.com>
Date: Aug 19, 2024, 20:08 UTC
Message-ID: <xmqqzfp8cm30.fsf@gitster.g>
In-Reply-To: <pull.1766.v3.git.1723389612.gitgitgadget@gmail.com>

"Jean-Noël Avila via GitGitGadget" <gitgitgadget@gmail.com> writes:

> Jean-Noël Avila (3):
>   doc: introduce a synopsis custom paragraph attribute
>   doc: update the guidelines to reflect the current formatting rules
>   doc: apply synopsis simplification on git-clone and git-init

This topic has become quiet. I still find s:["someything you really want to say"] notation a bit annoying to my eyes, but its may be the best compromise we can come up with.

So unless we have a strong objection, or (even better) an objection with an alternative that is less yucky, perhaps it is time to declare that this is the variant of AsciiDoc/Asciidoctor that we'd adopt for our documentation. Comments?

Thanks.

$ 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.