Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-pms
Navigation:
Lists: gentoo-pms: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: Ciaran McCreesh <ciaran.mccreesh@...>
From: Christian Faulhammer <fauli@g.o>
Subject: Re: EAPI 3 branch could use some reviewing
Date: Mon, 13 Apr 2009 10:49:44 +0200
Hi,

Ciaran McCreesh <ciaran.mccreesh@...>:
> On Sun, 12 Apr 2009 15:31:26 +0200
> Christian Faulhammer <fauli@g.o> 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:
signature.asc (PGP signature)
Replies:
Re: EAPI 3 branch could use some reviewing
-- Ciaran McCreesh
References:
EAPI 3 branch could use some reviewing
-- Ciaran McCreesh
Re: EAPI 3 branch could use some reviewing
-- Christian Faulhammer
Re: EAPI 3 branch could use some reviewing
-- Ciaran McCreesh
Navigation:
Lists: gentoo-pms: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: EAPI 3 branch could use some reviewing
Next by thread:
Re: EAPI 3 branch could use some reviewing
Previous by date:
Re: Patches for your reviewing pleasure: Various improvements, including cheat sheet
Next by date:
Re: Patches for your reviewing pleasure: Various improvements, including cheat sheet


Updated Jul 18, 2012

Summary: Archive of the gentoo-pms mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.