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
descriptions.
--
Joe Drew <hoserhead@woot.net> <drew@debian.org>
My weblog doesn't detail my personal life: http://me.woot.net
Reply to: