On Mon, 13 Apr 2009 10:49:44 +0200
Christian Faulhammer <fauli@gentoo.org> wrote:
> 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.

Actually, looking at that... I don't really see anything off about it.
Which bit specifically don't you like?

-- 
Ciaran McCreesh