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 1EXyfj-0006UK-H3 for garchives@archives.gentoo.org; Fri, 04 Nov 2005 10:19:48 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.13.5/8.13.5) with SMTP id jA4AIgmg005432; Fri, 4 Nov 2005 10:18:42 GMT Received: from smtp.gentoo.org (smtp.gentoo.org [134.68.220.30]) by robin.gentoo.org (8.13.5/8.13.5) with ESMTP id jA4AFQeN031645 for ; Fri, 4 Nov 2005 10:15:27 GMT Received: from user.scort.com ([213.41.103.70] helo=[10.1.10.18]) by smtp.gentoo.org with esmtpa (Exim 4.43) id 1EXybW-0005qH-GN for gentoo-dev@lists.gentoo.org; Fri, 04 Nov 2005 10:15:26 +0000 Message-ID: <436B34BD.7040509@gentoo.org> Date: Fri, 04 Nov 2005 11:15:25 +0100 From: Thierry Carrez Organization: Gentoo Linux User-Agent: Mozilla Thunderbird 1.0.6 (X11/20050728) X-Accept-Language: en-us, en 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 To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] GLEP ??: Critical News Reporting References: <20051101015125.1cc45eb4@snowdrop.home> <436AF548.8070406@ieee.org> <200511040032.25592.electronerd@monolith3d.com> <200511041033.06340.pauldv@gentoo.org> In-Reply-To: <200511041033.06340.pauldv@gentoo.org> X-Enigmail-Version: 0.92.0.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-Archives-Salt: 72733221-ecdc-4a12-81d8-1cb9a12c8a9d X-Archives-Hash: 03207643905d511f71c118aeba40162c Paul de Vrieze wrote: > Oh god help. This also points to another reason why this is not such a > good idea. Writing guideXML is a lot more work than writing an e-mail > format file (ciaran's proposed format for those who didn't recognize it). > > Also having double files containing the same information is broken by > design. OK so there is two options : 1- every "news" requires a GuideXML/RST/whatever errata at a central web location Pros: - non-portage user can easily browse errata - consistency in documentation Cons: - work overhead for errata-writing dev 2- every "news" requires just a short text-based item, extra doc is optional Pros: - flexibility: short news don't require writing extra doc - external doc reuse: the documentation referenced in the news item can be some upstream upgrade doc when sufficient Cons: - lack of consistency and difficulty for non-portage users to browse We can have the best of both worlds if we find a way to reduce the work overhead to 0 (using some kind of news2errataXml translator ?). If we can't, I tend to favor the second solution... -- Koon -- gentoo-dev@gentoo.org mailing list