Re: [PATCH 2/2] Documentation: convert SubmittingPatches to AsciiDoc
- From
- Paolo Ciarrocchi <paolo.ciarrocchi@gmail.com>
- Date
- Oct 31, 2017, 18:07 UTC
- Message-ID
- <CAHVLzckqV8+Bf91VsY95fo==97saHbq=R4xuCF0KX3FY8fgOwA@mail.gmail.com>
- In-Reply-To
- <alpine.DEB.2.21.1.1710311819590.6482@virtualbox>
On Tue, Oct 31, 2017 at 6:21 PM, Johannes Schindelin <Johannes.Schindelin@gmx.de> wrote:
Show 31 quoted lines
> Hi Paolo, > > On Mon, 30 Oct 2017, Paolo Ciarrocchi wrote: > >> On Mon, Oct 30, 2017 at 1:35 PM, Johannes Schindelin >> <Johannes.Schindelin@gmx.de> wrote: >> > >> > On Mon, 30 Oct 2017, Junio C Hamano wrote: >> > >> >> "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)). >> >> 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").
You are right. I've got confused by the fact that gmail fails to properly handle that link. Sorry for the noise.
Regards,
-- Paolo