From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1LtHrX-0006UG-2M for garchives@archives.gentoo.org; Mon, 13 Apr 2009 08:49:55 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 0FF3BE0795; Mon, 13 Apr 2009 08:49:54 +0000 (UTC) Received: from mo-p05-ob.rzone.de (mo-p05-ob.rzone.de [81.169.146.180]) by pigeon.gentoo.org (Postfix) with ESMTP id AA1F9E0795 for ; Mon, 13 Apr 2009 08:49:53 +0000 (UTC) X-RZG-AUTH: :K2kKYU+nW/MMMlTokcN5Yot1/Bj/FTl+WviP6RIJci0HRMpbh/x+X6ShOQjVOj0+68XXMxUENgO6 X-RZG-CLASS-ID: mo05 Received: from terra.solaris (p54AE66FB.dip.t-dialin.net [84.174.102.251]) by post.strato.de (mrclete mo23) (RZmta 18.28) with ESMTP id I00fd1l3D76fQS ; Mon, 13 Apr 2009 10:49:52 +0200 (MEST) Date: Mon, 13 Apr 2009 10:49:44 +0200 From: Christian Faulhammer To: Ciaran McCreesh Cc: gentoo-pms@lists.gentoo.org Subject: Re: [gentoo-pms] EAPI 3 branch could use some reviewing Message-ID: <20090413104944.54d4669f@terra.solaris> In-Reply-To: <20090412164355.36daa3b8@snowmobile> References: <20090411211410.05b02d24@snowmobile> <20090412153126.643a4c28@terra.solaris> <20090412164355.36daa3b8@snowmobile> X-Mailer: Claws Mail 3.7.1 (GTK+ 2.14.7; i686-pc-linux-gnu) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Package Manager Specification discussions X-BeenThere: gentoo-pms@gentoo.org X-BeenThere: gentoo-pms@lists.gentoo.org Mime-Version: 1.0 Content-Type: multipart/signed; boundary="Sig_/uE3U_t.UJz4TsbvBH3BT25z"; protocol="application/pgp-signature"; micalg=PGP-SHA1 X-Archives-Salt: 8504db75-22ac-4106-9aaf-87e0aedd21ca X-Archives-Hash: 5d688d55f1b38ac4d0f353bccebb4722 --Sig_/uE3U_t.UJz4TsbvBH3BT25z Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: quoted-printable Hi, Ciaran McCreesh : > On Sun, 12 Apr 2009 15:31:26 +0200 > Christian Faulhammer 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 --=20 Christian Faulhammer, Gentoo Lisp project , #gentoo-lisp on FreeNode --Sig_/uE3U_t.UJz4TsbvBH3BT25z Content-Type: application/pgp-signature; name=signature.asc Content-Disposition: attachment; filename=signature.asc -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.10 (GNU/Linux) iEYEARECAAYFAkni/KgACgkQNQqtfCuFnePD3gCfQgMFTggS/rd9e7lY6lD5wVr3 L58An1KtGPJibRg5rgRsBCCUsROyLb2K =UfoK -----END PGP SIGNATURE----- --Sig_/uE3U_t.UJz4TsbvBH3BT25z--