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

Hi Paolo,

On Mon, 30 Oct 2017, Paolo Ciarrocchi wrote:

On Mon, Oct 30, 2017 at 1:35 PM, Johannes Schindelin
[off-list ref] wrote:

quoted

On Mon, 30 Oct 2017, Junio C Hamano wrote:

quoted

"brian m. carlson" [off-list ref] 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)).

Nitpick, the right URL is: https://rtomayko.github.io/ronn/ronn.1.html
You put an extra ')' at the end and therefore I've got a scaring 404 error :-)

The first closing parenthesis closes the link associated with the label
`ronn`, the second closing parenthesis closes the remark I started in the
previous line (beginning with the word "using").

Ciao,
Johannes