From: Julia Evans Date: Tue, 03 Nov 2026 17:16:14 GMT Subject: Re: [PATCH] doc: git-diff: rewrite EXAMPLES section Message-ID: <57e9dc76-9cab-48e7-95c6-88868137202d@app.fastmail.com> In-Reply-To: > * 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/