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

2017-10-31 Thread Paolo Ciarrocchi
On Tue, Oct 31, 2017 at 6:21 PM, Johannes Schindelin wrote: > Hi Paolo, > > On Mon, 30 Oct 2017, Paolo Ciarrocchi wrote: > >> On Mon, Oct 30, 2017 at 1:35 PM, Johannes Schindelin >> wrote: >> > >> > On Mon, 30 Oct 2017, Junio C Hamano wrote: >> > >> >> "brian m. carlson" writes: >> >> >> >> Than

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

2017-10-31 Thread Johannes Schindelin
Hi Paolo, On Mon, 30 Oct 2017, Paolo Ciarrocchi wrote: > On Mon, Oct 30, 2017 at 1:35 PM, Johannes Schindelin > wrote: > > > > On Mon, 30 Oct 2017, Junio C Hamano wrote: > > > >> "brian m. carlson" writes: > >> > >> Thanks. I personally prefer the plain-text original, but I do > >> understand

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

2017-10-30 Thread brian m. carlson
On Mon, Oct 30, 2017 at 01:28:05PM +0900, Junio C Hamano wrote: > "brian m. carlson" 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 >

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

2017-10-30 Thread brian m. carlson
On Mon, Oct 30, 2017 at 01:35:19PM +0100, Johannes Schindelin wrote: > 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

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

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

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

2017-10-30 Thread Johannes Schindelin
Hi, On Mon, 30 Oct 2017, Junio C Hamano wrote: > "brian m. carlson" 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 directio

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

2017-10-29 Thread Junio C Hamano
"brian m. carlson" 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. > @@ -58,8 +65,9 @@ differs subs

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

2017-10-29 Thread brian m. carlson
The SubmittingPatches document is often cited by outside parties as an example of good practices to follow, including logical, independent commits; patch sign-offs; and sending patches to a mailing list. Currently, people who want to cite a particular section tend to either refer to it by name and