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.43) id 1EL0Xw-0005He-5f for garchives@archives.gentoo.org; Thu, 29 Sep 2005 15:42:08 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.13.5/8.13.5) with SMTP id j8TFXhMI024335; Thu, 29 Sep 2005 15:33:43 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 j8TFXh53010716 for ; Thu, 29 Sep 2005 15:33:43 GMT Received: from gentoo.xs4all.nl ([213.84.68.112] helo=[10.0.0.2]) by smtp.gentoo.org with esmtpa (Exim 4.43) id 1EL0Ww-00067Q-AP for gentoo-doc@lists.gentoo.org; Thu, 29 Sep 2005 15:41:06 +0000 Message-ID: <433C0B12.3000103@gentoo.org> Date: Thu, 29 Sep 2005 17:41:06 +0200 From: Xavier Neys User-Agent: Mozilla Thunderbird 1.0.6 (X11/20050803) X-Accept-Language: en-us, en Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-doc@gentoo.org Reply-to: gentoo-doc@lists.gentoo.org MIME-Version: 1.0 To: gentoo-doc@lists.gentoo.org Subject: Re: [gentoo-doc] [RFC] Marking unmaintained documents References: <43206D3A.5030406@gentoo.org> <432A89E5.8040205@gentoo.org> In-Reply-To: <432A89E5.8040205@gentoo.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Archives-Salt: 0c095284-6b01-46aa-9222-fccb4f382f16 X-Archives-Hash: a6ee9806498d5711c7428db315480654 Xavier Neys wrote: > Adding a disclaimer at the beginning of a doc is a good idea IMO. > > I have implemented a proposal with the following disclaimers: > "articles" for republished articles > "oldbook" self-explanatory > "obsolete" idem > Disclaimers can also auto-redirect users, very useful for obsolete docs. I have added "draft" and used attributes (disclaimer & redirect) instead of yet another element. It feels better(tm) to me. > Samples: > http://gentoo.neysx.org/mystuff/gentoo-x86-install.xml > http://gentoo.neysx.org/mystuff/l-sed2.xml > http://gentoo.neysx.org/mystuff/l-sed1.xml > http://gentoo.neysx.org/mystuff/oldbook.xml http://gentoo.neysx.org/mystuff/pocketpc-guide.xml > Now about outdated translations: Reminder: > 0) All languages must have a metadoc.xml. Not a problem IMO. > will do for currently unsupported languages. > 1) We have to use metadoc and *may not* test the corresponding file (ie. > s:/pl/:/en/:) as that would force us to keep files we want to remove in > /doc/en/ until all translated versions have disappeared. > 2) Reminder: the date of a handbook is the max_date(master, all parts) > 3) Some of you need to stop bumping dates needlessly because it would > make translations look older then they actually are. > 4) link attributes must contain the full path, no more link="handbook-x86.xml"> (not required on my test site, but would be on > www.g.o) > At the moment, it is limited to /doc as dates are not reliable outside > of /doc anyway (not yyyy-mm-dd formatted or not bumped properly). Sample: http://gentoo.neysx.org/doc/fr/distcc.xml > > FYI, an inserts would like like > http://gentoo.neysx.org/doc/en/inserts-en.xml?passthru=1 Disclaimer & redirect () Yea () Nay Note about more recent English version () Yea () Nay Cheers, -- / Xavier Neys \_ Gentoo Documentation Project / French & Internationalisation Lead \ http://www.gentoo.org/doc/en /\ -- gentoo-doc@gentoo.org mailing list