Dear Ftpmasters, I'm forwarding you these issue (sent to debian-cd and debian-i18n) since it seems that the layout has not been set by them (the Debian-cd group just copies all the information available under ftp.debian.org/debian/doc when making the cd images) In spite of my "timing sense" (hint hint :) being questioned IMHO this issue could be fixed in time for release. I can volunteer the core work (moving around files and fixing the Makefiles that publish the documentation if any) to improve the current situation. Please read the adjointed message. And thank you in advance for any help you can provide. Javier Fernandez-Sanguino Peña PS: Also please note that we could also take the chance of providing the DDP documentation (which is currently not added to /doc) PPS: Regarding the boot-floopies comments below, after a bit of research it seems that it is due to translation teams not updating the proper Makefiles. ----- Forwarded message from Javier Fernández-Sanguino Peña <jfs@computer.org> ----- Resent-Date: Tue, 30 Apr 2002 15:26:04 -0400 X-Envelope-Sender: jfs@dat.etsit.upm.es From: Javier Fernández-Sanguino Peña <jfs@computer.org> To: debian-cd@lists.debian.org, debian-i18n@lists.debian.org Subject: Documentation provided in the Woody CDs (should be fixed) X-Spam-Status: No, hits=0.0 required=4.7 tests= version=2.01 Resent-Message-ID: <NMCmm.A.CAE.wzuz8@murphy> Resent-From: debian-i18n@lists.debian.org X-Mailing-List: <debian-i18n@lists.debian.org> archive/latest/1383 List-Post: <mailto:debian-i18n@lists.debian.org> List-Help: <mailto:debian-i18n-request@lists.debian.org?subject=help> List-Subscribe: <mailto:debian-i18n-request@lists.debian.org?subject=subscribe> List-Unsubscribe: <mailto:debian-i18n-request@lists.debian.org?subject=unsubscribe> Resent-Sender: debian-i18n-request@lists.debian.org I have just taken a look at the latest image (I think it is, but it was downloaded from a European mirror) of woody CDs. More precisely: $ ls 00-INDEX constitution.txt dedication-2.2.ja.txt FAQ debian-keyring.tar.gz dedication-2.2.pt_BR.txt TRANS.TBL debian-manifesto dedication-2.2.sigs.tar.gz bug-log-access.txt dedication-2.2.cn.txt dedication-2.2.txt bug-log-mailserver.txt dedication-2.2.de.txt install bug-mailserver-refcard.txt dedication-2.2.es.txt mailing-lists.txt bug-maint-info.txt dedication-2.2.fi.txt package-developer bug-maint-mailcontrol.txt dedication-2.2.fr.txt social-contract.txt bug-reporting.txt dedication-2.2.it.txt source-unpack.txt dedication-2.2 -> should be removed? FAQ -> it is only provided in english however there are -es -fr -ja and -ko debian-doc packages (the CVS seems not to have these but it does have pt_BR and ru) mailing-list.txt/social-contract.txt/constitution.txt (maybe all the .txt files) -> they are already translated in the WWW server since the contents are the same as web pages there, translated content is not provided. install -> only links provided for english documentation, however the install/doc directory contains other languages. Wouldn't it be better to have doc/install a link to install/doc ? Also please check Bug #58638. Even if the boot-floppies documentation is translated to many languages I seem to find only a few (it,cs,da,ca). IMHO this whole doc directory in the CDs (which is taken IIRC from the ftp.debian.org site) should be completely reorganised. Proposed layout: doc |- README (describes the layout and points to www.debian.org/doc/ for | uptodate documentation and to www.debian.org/releases/stable) |- README.XX (other languages describing the layout, similar content) |- FAQ | |- en | |- es | |- it | |- ... |- debian (current *.txt files, manifesto, constitution, information | specific to the debian project and distribution) | |- en | |- ... ( translations should be derived from WWW site) | |- package-developer | (same layout as above it is currently a mess of formats and languages) | |- installation -> ../install/doc It is very important that the layout is language-independant and that there is one directory for each language. All README files should point to the relevant information and all README.XXX files should provide relevant information on translated content and provide a pointer to the original source (english) to those documents not translated. Yes, we are *almost* finished releasing but this issue has not been tackled in the previous release and a reorganization (even if done manually for this release and automated for the rest) should not take more than a few hours (give me access and I will do it myself if no one can). Can this issue be tackled? (I expect many to say no :( Regards (and sorry for the cross-post) Javi PS: Since I do not want to become everyone's pain-in-the-ass and I did not send this in before (too busy at work) I will not (for the moment) file any RC bug report :) ----- End forwarded message ----- --
Attachment:
pgpktvcIsKFB5.pgp
Description: PGP signature