1 |
Hi, |
2 |
|
3 |
Ciaran McCreesh <ciaran.mccreesh@××××××××××.com>: |
4 |
> On Sun, 12 Apr 2009 15:31:26 +0200 |
5 |
> Christian Faulhammer <fauli@g.o> wrote: |
6 |
> > The explanations of the slot operators are a bit hard to read, |
7 |
> > maybe rephrasing (and splitting in more sentences) is the way to go |
8 |
> > here. |
9 |
> |
10 |
> I suspect those're hard to read because people are expecting a |
11 |
> user-centric description of what they're for, rather than a package |
12 |
> manager centric description of how they behave. |
13 |
|
14 |
But also package manager coders are humans (at least the last time I |
15 |
checked), and apart from accuracy a technical documentation needs |
16 |
readability in its own special way. I wrote enough "scientific" and |
17 |
technical documents to be sure that small, easy to understand sentences |
18 |
are better. |
19 |
|
20 |
V-Li |
21 |
|
22 |
-- |
23 |
Christian Faulhammer, Gentoo Lisp project |
24 |
<URL:http://www.gentoo.org/proj/en/lisp/>, #gentoo-lisp on FreeNode |
25 |
|
26 |
<URL:http://gentoo.faulhammer.org/> |