Re: [gentoo-pms] EAPI 3 branch could use some reviewing

[Christian Faulhammer <fauli@gentoo.org>]

[-- Attachment #1: Type: text/plain, Size: 952 bytes --]

Hi,

Ciaran McCreesh <ciaran.mccreesh@googlemail.com>:
> On Sun, 12 Apr 2009 15:31:26 +0200
> Christian Faulhammer <fauli@gentoo.org> wrote:
> >  The explanations of the slot operators are a bit hard to read,
> > maybe rephrasing (and splitting in more sentences) is the way to go
> > here.
>
> I suspect those're hard to read because people are expecting a
> user-centric description of what they're for, rather than a package
> manager centric description of how they behave.

 But also package manager coders are humans (at least the last time I
checked), and apart from accuracy a technical documentation needs
readability in its own special way.  I wrote enough "scientific" and
technical documents to be sure that small, easy to understand sentences
are better.

V-Li

-- 
Christian Faulhammer, Gentoo Lisp project
<URL:http://www.gentoo.org/proj/en/lisp/>, #gentoo-lisp on FreeNode

<URL:http://gentoo.faulhammer.org/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 198 bytes --]