Re: [PATCH] doc: git-diff: rewrite EXAMPLES section

From: Julia Evans <julia@jvns.ca>
Date: Nov 3, 2026, 17:16 UTC
Message-ID: <57e9dc76-9cab-48e7-95c6-88868137202d@app.fastmail.com>
In-Reply-To: <pull.2293.git.1793720007182.gitgitgadget@gmail.com>

Show 7 quoted lines

>      * I'm not 100% sure about the table format, it does make it more
>        compact which is really nice and makes it much more readable, but on
>        an 80-character terminal there is some wrapping. One potential con is
>        that it means we can't include as many details about what the command
>        does. From my point of view that's a good thing because in a "cheat
>        sheet" format it's very important to be concise, and people can
>        always read the rest of the man page for the details.

While working on something else immediately after sending this, I learned that Asciidoc has support for horizontal definition lists which I think would make more sense than a table here. And they can be easily changed to a vertical definition list by just removing the [horizontal] if there's an issue in the future. https://docs.asciidoctor.org/asciidoc/latest/lists/horizontal/