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

From: Paolo Ciarrocchi <paolo.ciarrocchi@gmail.com>
Date: Oct 30, 2017, 17:40 UTC
Message-ID: <CAHVLzcnS6n_BODDo3wrBzNkpEPTYBLD0V51H4O10q82J=xYnqw@mail.gmail.com>
In-Reply-To: <alpine.DEB.2.21.1.1710301333420.6482@virtualbox>

On Mon, Oct 30, 2017 at 1:35 PM, Johannes Schindelin <Johannes.Schindelin@gmx.de> wrote:

Show 19 quoted lines

> Hi,
>
> 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 :-)

Ciao,

-- 
Paolo