Gentoo Archives: gentoo-dev

From: "Michał Górny" <mgorny@g.o>
To: gentoo-dev@l.g.o
Cc: pacho@g.o
Subject: Re: [gentoo-dev] About DESCRIPTION in ebuilds needing to end with a dot "."
Date: Fri, 19 Oct 2012 20:37:54
Message-Id: 20121019223736.33f2ee38@pomiocik.lan
In Reply to: [gentoo-dev] About DESCRIPTION in ebuilds needing to end with a dot "." by Pacho Ramos
1 On Fri, 19 Oct 2012 21:01:57 +0200
2 Pacho Ramos <pacho@g.o> wrote:
3
4 > At least in spanish, it's mandatory to end phrases with a dot ".", would
5 > you agree with trying to enforce this trivial change with a repoman
6 > warning?
7
8 In my opinion, descriptions should not be sentences. Sentences
9 in English not only need to end with a dot but also require a subject
10 and a predicate. That makes them unnecessarily long, filled with
11 useless information like repeated package name and obvious 'is',
12 at least.
13
14 So, rephrasing the example Alexandre pasted, consider:
15
16 x11-libs/qt-core - The Qt toolkit is a comprehensive C++ application
17 development framework.
18
19 vs.
20
21 x11-libs/qt-core - A comprehensive C++ application development framework
22
23 Which one is better, in your opinion?
24
25 --
26 Best regards,
27 Michał Górny

Attachments

File name MIME type
signature.asc application/pgp-signature

Replies