From owner-freebsd-doc Mon Mar 12 14:16:39 2001 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 781A137B71C for ; Mon, 12 Mar 2001 14:16:19 -0800 (PST) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.1/8.11.1) id f2CLlP074300; Mon, 12 Mar 2001 21:47:25 GMT (envelope-from nik) Date: Mon, 12 Mar 2001 21:47:25 +0000 From: Nik Clayton To: Udo Erdelhoff Cc: doc@FreeBSD.org Subject: Re: Translators: Need feedback on FAQ reorganization Message-ID: <20010312214725.B74204@canyon.nothing-going-on.org> References: <20010311125040.E31751@holly.calldei.com> <20010312003518.A77178@nathan.ruhr.de> <20010312093709.B3114@canyon.nothing-going-on.org> <20010312212209.G77178@nathan.ruhr.de> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="lEGEL1/lMxI0MVQ2" Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010312212209.G77178@nathan.ruhr.de>; from ue@nathan.ruhr.de on Mon, Mar 12, 2001 at 09:22:09PM +0100 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --lEGEL1/lMxI0MVQ2 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Mar 12, 2001 at 09:22:09PM +0100, Udo Erdelhoff wrote: > Hi, > > On Mon, Mar 12, 2001 at 12:35:18AM +0100, Udo Erdelhoff wrote: > > > [0] It might be possible to use the "our" repository (i.e. that of the > > > FreeBSD German Documentation Project) for this purpose. I'll talk to > > > Alexander Langer (alex@big.endidan.de) about it, it's his box. > >=20 > > Why do you guys have a separate repository? Does it make things easier > > somehow? >=20 > yes, it does. The three people who are listed in the first commit message > on freefall aren't committers and a local repository was the only way to > get the ball rolling.=20 Do they want to be committers now? If you guys trust them not to screw up then that's good enough for me. > The second big advantage of a local repository is the ability to include > changes that would cause an outcry if somebody took a closer look at > the markup in the german version.=20 Hmm. > The german version doesn't have links to man.cgi,=20 Neither should the English version. If it does, it's a bug. PR? > we don't have anymore Ditto. Since the other translations key off the English versions, these changes that you make to the German FAQ to improve it won't then make it in to any other translations (or the English version). I think that's a bad thing. > , the book listings are actually usable,=20 Define usable. Something I should have added to the ToDo list I posted. I've got the beginnings of a "bibliography" book that can contain all the recommended reading. Take a look at the attached book.sgml for the idea. Basically, we'd have a standalong bibliography book, if someone just wants to see a list of every book we recommend. And if we have documents like the Handbook, or the FAQ, that also want to refer to a specific book, the don't have to duplicate the information. They can just reference the biblioentry's id, and the stylesheets will pull in the data. So we only have one bibliography to list across the entire project. I don't know yet whether each language should have its own bibliography, or whether it belongs somewhere under doc/share/sgml/. Now's as good a time as any to discuss this in more detail. > the links to amazon.com work,=20 See my other comments. > there are no useless > around lists,=20 Ditto. > Nemeth edition 3, ... Ditto. > "If it is worth doing, it is worth doing it right." I agree. I'd appreciate your help in making sure that all the translations have been improved, not just the German version. N --=20 FreeBSD: The Power to Serve http://www.freebsd.org/ FreeBSD Documentation Project http://www.freebsd.org/docproj/ --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- --lEGEL1/lMxI0MVQ2 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.4 (FreeBSD) Comment: For info see http://www.gnupg.org iEYEARECAAYFAjqtQ+wACgkQk6gHZCw343U3+wCgj6CsWhXda0dyHetulgwomfmN wCgAoIYcx2qss9N00Hu+dOVc94hipZYf =TRbp -----END PGP SIGNATURE----- --lEGEL1/lMxI0MVQ2-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message