From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from lists.gentoo.org ([140.105.134.102] helo=robin.gentoo.org) by nuthatch.gentoo.org with esmtp (Exim 4.50) id 1EggU0-0006xr-3y for garchives@archives.gentoo.org; Mon, 28 Nov 2005 10:43:40 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.13.5/8.13.5) with SMTP id jASAgHdC014453; Mon, 28 Nov 2005 10:42:17 GMT Received: from callisto.cs.kun.nl (callisto.cs.kun.nl [131.174.33.75]) by robin.gentoo.org (8.13.5/8.13.5) with ESMTP id jASAccFt005812 for ; Mon, 28 Nov 2005 10:38:38 GMT Received: from localhost (localhost [127.0.0.1]) by callisto.cs.kun.nl (Postfix) with ESMTP id 0BB292E8217 for ; Mon, 28 Nov 2005 11:39:17 +0100 (CET) From: Paul de Vrieze To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] Maintainer's guides? Date: Mon, 28 Nov 2005 11:39:08 +0100 User-Agent: KMail/1.8.92 References: <200511240101.45977@enterprise.flameeyes.is-a-geek.org> <200511241231.48384@enterprise.flameeyes.is-a-geek.org> <200511271843.01552@enterprise.flameeyes.is-a-geek.org> In-Reply-To: <200511271843.01552@enterprise.flameeyes.is-a-geek.org> X-Face: #Lb+'V@sGJ;ptgo5}V"W+5OCoo{LZv;bh,s,`WKLi/J)ed1_$0;6X<=?utf-8?q?700LVV/=3BLqPhiDP=5E=0A=09=27f=5Dfnv?=@%6M8\'HR1t=aFx;ePfp{ZQoBe+e)JOQ8T5*(_;mHY+cltLGq<;@$Y,=?utf-8?q?O=5C=24=0A=09Tm=23G6M?=,g![Q62J{na*S9d;R[^8pc%u\aiLqU@`kJtYl"^6pxdW Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@gentoo.org Reply-to: gentoo-dev@lists.gentoo.org MIME-Version: 1.0 Content-Type: multipart/signed; boundary="nextPart6291082.cCAVVHIuL3"; protocol="application/pgp-signature"; micalg=pgp-sha1 Content-Transfer-Encoding: 7bit Message-Id: <200511281139.16339.pauldv@gentoo.org> X-Archives-Salt: 9fd860c3-1a94-4d30-a51d-4683f55e2457 X-Archives-Hash: 57892102e5e56136c8064a5c223d2e91 --nextPart6291082.cCAVVHIuL3 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Content-Disposition: inline On Sunday 27 November 2005 18:43, Diego 'Flameeyes' Petten=C3=B2 wrote: > On Thursday 24 November 2005 12:31, Diego 'Flameeyes' Petten=C3=B2 wrote: > > What I'm waiting for now are comments if someone has ideas where to > > put guides that does not belong directly to an existant project. And > > if someone wants to join the effort of documenting maintenance > > process for his packages, it would be helpful, too. > > Trying not to let this idea die, as I still think it might be good in > the long run, especially if there's a way to get them collected in a > single place. Right now the main problem is that they are spread across > projects (at least video/sound projects). > > Possible solutions I thought of: > > 1) have every herd controlled by a project, so that the maintainers' > guides can be committed there; it would be difficult to find the > maintainer's guide for a package this way; > 2) have a single repository for maintainers' guides that does not > belong to other projects; > 3) have a single repository for *every* maintainers' guide. > > The problem with 1 and 2 is that the maintainers' guides would be > difficult to locate in the mess of projects. The problem of 3 is that > we have already complex maintainers' guides such as xine's and the one > spyderous wrote for X11 herd, that might be difficult to fit in a > single organization.. > I agree with you. Although it is straightforward to provide a reverse=20 mapping from packages to herds to projects, that currently doesn't exist. > To solve 1's and 2's problem, the solution could be adding a > tag to metadata.xml, that carries the URL to the > maintainer's guide for the package. It would also make simpler, for > example, the case where a single guide is used for more than one > package (see always xine's). In any way I like the idea to add a tag to the metadata.xml files. I would= =20 however want to do it differently. I'd like to propose a general =20 tag with the usual attributes (version/deprange, language) and as new=20 attributes a "src" and a "kind" attribute. For your case it would then=20 be: This way other gentoo (and other) documentation could be linked to the=20 package. Paul ps. We might even link to external (upstream) documentation, and have=20 packages.gentoo.org provide that info. =2D-=20 Paul de Vrieze Gentoo Developer Mail: pauldv@gentoo.org Homepage: http://www.devrieze.net --nextPart6291082.cCAVVHIuL3 Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.2-ecc0.1.6 (GNU/Linux) iD8DBQBDit5UbKx5DBjWFdsRAmr2AJ9xiVybrD+DoXcbSNtnxAo4yrxFSwCgkcY5 QDsKrcnh5gM7V3wXjjO4bbQ= =O8DR -----END PGP SIGNATURE----- --nextPart6291082.cCAVVHIuL3-- -- gentoo-dev@gentoo.org mailing list