Debconf Templates Style Guide : round 2

2003-11-10 Thread Christian Perrier
After publishing my first draft of the so-called Debconf Templates Style Guide (DTSGmaybe this acronym is too close from the DFSG) on October 28th, I have received many input and I have completed some parts of the document. Thanks to all people who already commented or encouraged me to

Re: Debconf Templates Style Guide

2003-11-02 Thread Henning Makholm
Scripsit Matt Zimmerman <[EMAIL PROTECTED]> > On Fri, Oct 31, 2003 at 07:43:09PM +0100, Henning Makholm wrote: > > So instead you're recommending an approach that forces the user to > > choose *before* reconfiguring between > > a) not being told what the maintainer thought was a sensible default

Re: Debconf Templates Style Guide

2003-10-31 Thread Matt Zimmerman
On Fri, Oct 31, 2003 at 07:43:09PM +0100, Henning Makholm wrote: > Scripsit Matt Zimmerman <[EMAIL PROTECTED]> > > > Of course it would, and I would never recommend doing so. > > So instead you're recommending an approach that forces the user to > choose *before* reconfiguring between > a) not

Re: Debconf Templates Style Guide

2003-10-31 Thread Henning Makholm
Scripsit Matt Zimmerman <[EMAIL PROTECTED]> > Of course it would, and I would never recommend doing so. So instead you're recommending an approach that forces the user to choose *before* reconfiguring between a) not being told what the maintainer thought was a sensible default b) not being told

Re: Debconf Templates Style Guide

2003-10-31 Thread Henning Makholm
Scripsit Christian Perrier <[EMAIL PROTECTED]> > > There used to be, somewhere, a guideline that told maintainers to let > > themselves be inspired by the descriptions in the kernel source's > > "make fooconfig", especially with regard to telling the user what the > > conservative default choice i

Re: Debconf Templates Style Guide

2003-10-30 Thread Branden Robinson
On Thu, Oct 30, 2003 at 07:07:33AM +0100, Christian Perrier wrote: > > Someone do this please? :) > > Branden, no other comment on my document ? > > I was more or less prepared to several (constructive) comments, or > style corrections, coming from you and I'm wondering whether I should > be gl

Re: Debconf Templates Style Guide

2003-10-30 Thread Christian Perrier
> Someone do this please? :) Branden, no other comment on my document ? I was more or less prepared to several (constructive) comments, or style corrections, coming from you and I'm wondering whether I should be glad of receiving none.. :-) -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with

Re: Debconf Templates Style Guide

2003-10-29 Thread Branden Robinson
On Tue, Oct 28, 2003 at 11:43:55PM -0500, Matt Zimmerman wrote: > On Wed, Oct 29, 2003 at 03:52:27AM +0100, Henning Makholm wrote: > > > The default choice should always be what the user wants if they are > > > unsure. > > > > I'm afraid you need to redesign the entire debconf system then. > > No

Re: Debconf Templates Style Guide

2003-10-29 Thread Christian Perrier
> There used to be, somewhere, a guideline that told maintainers to let > themselves be inspired by the descriptions in the kernel source's > "make fooconfig", especially with regard to telling the user what the > conservative default choice is. Many of the kernel option descriptions > do indeed sa

Re: Debconf Templates Style Guide

2003-10-28 Thread Matt Zimmerman
On Wed, Oct 29, 2003 at 03:52:27AM +0100, Henning Makholm wrote: > That would be a horrible sentence to put into a debconf > description. Of course it would, and I would never recommend doing so. > > The default choice should always be what the user wants if they are > > unsure. > > I'm afraid

Re: Debconf Templates Style Guide

2003-10-28 Thread Henning Makholm
Scripsit Matt Zimmerman <[EMAIL PROTECTED]> > On Tue, Oct 28, 2003 at 11:11:13PM +0100, Henning Makholm wrote: >> especially with regard to telling the user what the conservative >> default choice is. Many of the kernel option descriptions do indeed >> say "If unsure, answer No" or the like. Or do

Re: Debconf Templates Style Guide

2003-10-28 Thread Matt Zimmerman
On Tue, Oct 28, 2003 at 11:11:13PM +0100, Henning Makholm wrote: > There used to be, somewhere, a guideline that told maintainers to let > themselves be inspired by the descriptions in the kernel source's > "make fooconfig", especially with regard to telling the user what the > conservative defaul

Re: Debconf Templates Style Guide

2003-10-28 Thread Henning Makholm
Scripsit Christian Perrier <[EMAIL PROTECTED]> [much good stuff snipped] > Templates text should not make reference to widgets belonging to some > debconf interfaces. Sentences like "I you answer Yes..." have no > meaning for users of graphical interfaces which use checkboxes for > boolean questi

Debconf Templates Style Guide

2003-10-28 Thread Christian Perrier
write Good English -debian-devel because I like being flamed^W^W^W^W^W...because I want to reach as many DD's as possible Please commentand remember that this document is far from being finished... :) Up to now, thanks to Joey Hess and Denis Barbier for their initial proofreading.