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

Re: [PATCH 2/2] Documentation: convert SubmittingPatches to AsciiDoc

From
Johannes Schindelin <johannes.schindelin@gmx.de>
Date
Oct 30, 2017, 12:35 UTC
Message-ID
<alpine.DEB.2.21.1.1710301333420.6482@virtualbox>
In-Reply-To
<xmqqa8096yzu.fsf@gitster.mtv.corp.google.com>
Hi,
On Mon, 30 Oct 2017, Junio C Hamano wrote:
Show 6 quoted lines
> "brian m. carlson" <sandals@crustytoothpaste.net> writes:
> 
> Thanks.  I personally prefer the plain-text original, but I do
> understand the need to have a version with ids that you can tell
> others to visit in their browsers.  Assuming that this goes in the
> right direction, here are a few comments.

If you want to go into the direction of the web, AsciiDoc is actually the wrong choice IMO, and Markdown would be the right choice. Basically everybody on the web is either supporting Markdown or being asked by users to do so.

Assuming that *that* is something we want to pursue, I would also suggest to move the man pages away from AsciiDoc to Markdown (using e.g. [ronn](https://rtomayko.github.io/ronn/ronn.1.html)).

Ciao, Dscho

Previous: Junio C HamanoNext: Paolo Ciarrocchi
Message 5 of 10 in “Convert SubmittingPatches to AsciiDoc”
  1. 0/2 Convert SubmittingPatches to AsciiDocbrian m. carlson, Oct 29, 2017
  2. 1/2 Documentation: enable compat-mode for Asciidoctorbrian m. carlson, Oct 29, 2017
  3. 2/2 Documentation: convert SubmittingPatches to AsciiDocbrian m. carlson, Oct 29, 2017
  4. Junio C HamanoOct 30, 2017
  5. Johannes SchindelinOct 30, 2017
  6. Paolo CiarrocchiOct 30, 2017
  7. Johannes SchindelinOct 31, 2017
  8. Paolo CiarrocchiOct 31, 2017
  9. brian m. carlsonOct 30, 2017
  10. brian m. carlsonOct 31, 2017

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.