[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Best pratices for short descriptions [was: Bug#220780: ITP: zope-zms -- Content management for science, technology and medicine]

On Tue, 2003-11-25 at 18:08, Florent Rougon wrote:
> [A] lot of software has a canonical name that starts
> lowercase. ucLinux is one of them.
[lots of pseudo-hostile stuff snipped]

Clearly ucLinux and other proper nouns which have non-standard
capitalisations break the example which I've been mentioning. That
doesn't imply that you should throw out all the other rules that have
been developed (not by me, I should add).

How about the following:
In the short description, capitalisation should be used only for proper
nouns and acronyms; when capitalising, use the word's usual style, e.g
XFree86 and ucLinux.

This provides an easy-to-follow rule which brings consistency to package

Joe Drew <hoserhead@woot.net> <drew@debian.org>

My weblog doesn't detail my personal life: http://me.woot.net

Reply to: