Re: "Description improvement" probably not
On Fri, 11 Oct 2002, Martin Schulze wrote:
> Joey Hess wrote:
> > In filing that bug, Martin ignored my previous two protestations that I
> > am capable of calitalizing words on my own, and that I disagree that
> > this is necessary if the description is not a complete sentence.
. . .
> To my knowledge there was consensous to capitalize the first word of
> the one-line description as one should do with regular sentences.
>
> This "best packaging practice" helps recognizing the description fast
> for humans and is also documented in the Develpers Reference[1]
>
> For consistency and for an aesthetic concern, you should capitalize
> the first letter of the description.
. . .
> 1. http://www.debian.org/doc/developers-reference/ch-best-pkging-practices.en.html#s-writing-desc
As one who has spent the last 40[sic] years of his professional life
lecturing on and practising the use of the English language for communicative
purposes -- from undergraduate to post-doctoral level -- I would ask that this
consensus be respected by all writers contributing to the Debian Project.
Use of language is an extremely personal, and highly emotive, subject -- but
even the most understanding and sensitive of publishing houses will insist on
their own house rules being followed, if only in the name of consistency.
It is just too easy for the individual working at the micro-level to lose
sight of the bigger picture at the macro-level.
--
Martin Wheeler - StarTEXT / AVALONIX - Glastonbury - BA6 9PH - England
msw@startext.demon.co.uk http://startext.demon.co.uk/
GPG pub key : 8D6B948B ECC6 D98E 4CC8 60E3 7E32 D594 BB27 3368 8D6B 948B
- Share your knowledge. It's a way of achieving immortality. -
Reply to: