Hi Paolo, On Mon, 30 Oct 2017, Paolo Ciarrocchi wrote: > On Mon, Oct 30, 2017 at 1:35 PM, Johannes Schindelin > <Johannes.Schindelin@xxxxxx> wrote: > > > > On Mon, 30 Oct 2017, Junio C Hamano wrote: > > > >> "brian m. carlson" <sandals@xxxxxxxxxxxxxxxxxxxx> 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