On Mon, Oct 30, 2017 at 1:35 PM, Johannes Schindelin <Johannes.Schindelin@xxxxxx> wrote: > Hi, > > 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 :-) Ciao, -- Paolo