Bug#926656: git-debrebase docs are intimidating

2019-07-21 Thread Ian Jackson
(Dropping Colin again) Sean Whitton writes ("Bug#926656: git-debrebase docs are intimidating"): > On Sat 20 Jul 2019 at 11:50PM +01, Ian Jackson wrote: > > How about this ? > > I build the manpage with this version, and I find it readable. Nice > work. At last! Gre

Bug#926656: git-debrebase docs are intimidating

2019-07-21 Thread Sean Whitton
Hello, On Sat 20 Jul 2019 at 11:50PM +01, Ian Jackson wrote: > Sean Whitton writes ("Bug#926656: git-debrebase docs are intimidating"): >> An alternative which would satisfy these concerns and hopefully yours >> too would be this: > > In your version I find it dif

Bug#926656: git-debrebase docs are intimidating

2019-07-20 Thread Ian Jackson
Sean Whitton writes ("Bug#926656: git-debrebase docs are intimidating"): > An alternative which would satisfy these concerns and hopefully yours > too would be this: In your version I find it difficult to separate commands out from the labels. Which is precisely your problem

Bug#926656: git-debrebase docs are intimidating

2019-07-20 Thread Sean Whitton
Hello, On Sat 20 Jul 2019 at 07:27PM +01, Ian Jackson wrote: > Hmm. IMO: > > - Your approach uses 3 times as much vertical space. The whole QR > runeset doesn't now appear in the first page in a 25 line terminal. > > - It leads with prose, not the runes. But the runes are supposed > to be

Bug#926656: git-debrebase docs are intimidating

2019-07-20 Thread Sam Hartman
Either of these approaches would have been enough to make things less intimidating to me.

Bug#926656: git-debrebase docs are intimidating

2019-07-20 Thread Ian Jackson
Hi, Colin. Sorry to bring you into this unexpectedly. I'm hoping you might have time to have an opinion on the git-debrebase manpage. We're proposing to add a QUICK REFERENCE section very near the top, and are debating what it should be like. Sean Whitton writes ("Re: Bug#926656: git-debr

Bug#926656: git-debrebase docs are intimidating

2019-07-20 Thread Sean Whitton
Hello, On Sat 20 Jul 2019 at 05:34PM +01, Ian Jackson wrote: > Hi. Thanks for this. I'm not entirely convinced. It seems rather, > err, flabby and discursive. It is intimidating in its own way, "do I > need to read all of this for the quick reference" ? > > A quick reference does not need to

Bug#926656: git-debrebase docs are intimidating

2019-07-20 Thread Ian Jackson
Sean Whitton writes ("Re: Bug#926656: git-debrebase docs are intimidating"): > On Mon 08 Apr 2019 at 03:43PM +01, Ian Jackson wrote: > > Package: git-debrebase > > Version: 8.4 > > > > Sam Hartman wrote the following me in private email. It is a apposi

Bug#926656: git-debrebase docs are intimidating

2019-07-20 Thread Sean Whitton
control: tag -1 +patch Hello, On Mon 08 Apr 2019 at 03:43PM +01, Ian Jackson wrote: > Package: git-debrebase > Version: 8.4 > > Sam Hartman wrote the following me in private email. It is a apposite > (and sadly hilarious) critique of the documentation. I am filing it > here as a bug, with

Bug#926656: git-debrebase docs are intimidating

2019-04-09 Thread Sean Whitton
Hello, On Mon 08 Apr 2019 at 10:33PM -04, Sam Hartman wrote: > I don't know. > As I said in my mail I'm not even sure there's a problem here. > > Let me give a bit of background here. > Ian and I had what I thought was a really exciting call about git and > source packages and stuff. > > It

Bug#926656: git-debrebase docs are intimidating

2019-04-08 Thread Sam Hartman
I don't know. As I said in my mail I'm not even sure there's a problem here. Let me give a bit of background here. Ian and I had what I thought was a really exciting call about git and source packages and stuff. It sounded like Ian hopes we'll some day get rid of patches-unapplied data models

Bug#926656: git-debrebase docs are intimidating

2019-04-08 Thread Sean Whitton
Hello, On Mon 08 Apr 2019 at 03:43PM +0100, Ian Jackson wrote: > From: Sam Hartman Thank you for your continued interest in dgit and gdr, Sam! > To: Ian Jackson Subject: Re: git > debrebase is cool Date: Sat, 06 Apr 2019 13:01:57 -0400 > >> "Ian" == Ian Jackson writes: > Ian> Did

Bug#926656: git-debrebase docs are intimidating

2019-04-08 Thread Ian Jackson
Package: git-debrebase Version: 8.4 Sam Hartman wrote the following me in private email. It is a apposite (and sadly hilarious) critique of the documentation. I am filing it here as a bug, with permission. Ian. -8<- From: Sam Hartman To: Ian Jackson Subject: Re: git debrebase is cool Date: