From owner-freebsd-doc Thu Mar 15 11:21:14 2001 Delivered-To: freebsd-doc@freebsd.org Received: from mail.ruhr.de (in-ruhr4.ruhr.de [212.23.134.2]) by hub.freebsd.org (Postfix) with SMTP id DD0C637B719 for ; Thu, 15 Mar 2001 11:21:07 -0800 (PST) (envelope-from ue@nathan.ruhr.de) Received: (qmail 11993 invoked by uid 10); 15 Mar 2001 19:21:06 -0000 Received: (from ue@localhost) by nathan.ruhr.de (8.11.3/8.11.2) id f2FJ3bg98512 for doc@FreeBSD.org; Thu, 15 Mar 2001 20:03:37 +0100 (CET) (envelope-from ue) Date: Thu, 15 Mar 2001 20:03:37 +0100 From: Udo Erdelhoff To: doc@FreeBSD.org Subject: Re: Translators: Need feedback on FAQ reorganization Message-ID: <20010315200337.N83336@nathan.ruhr.de> Mail-Followup-To: doc@FreeBSD.org References: <20010312003518.A77178@nathan.ruhr.de> <20010312093709.B3114@canyon.nothing-going-on.org> <20010312212209.G77178@nathan.ruhr.de> <20010312214725.B74204@canyon.nothing-going-on.org> <20010313002953.I77178@nathan.ruhr.de> <20010313124524.B2130@canyon.nothing-going-on.org> <20010313231654.G83336@nathan.ruhr.de> <20010314131233.C6138@canyon.nothing-going-on.org> <20010314210730.J83336@nathan.ruhr.de> <20010315023806.B46684@canyon.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010315023806.B46684@canyon.nothing-going-on.org>; from nik@freebsd.org on Thu, Mar 15, 2001 at 02:38:06AM +0000 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, Mar 15, 2001 at 02:38:06AM +0000, Nik Clayton wrote: > On Wed, Mar 14, 2001 at 09:07:30PM +0100, Udo Erdelhoff wrote: > I still can't see anything in my archives, other than the biblio stuff, > that comes close to this. Don't be so self-centered ;-) > If you've submitted stuff to the -doc list before and not had any feedback > then I'm sorry, but sometimes that's how things work. Yeah, that's what I told myself the first time a month's work went down the drain. I still believed it the second time. By the third time, I took the hint and stopped doing it. > I've got > a bunch of e-mails pending in my -doc spool that I haven't replied to > yet, simply because I don't have the cycles to do them the justice they > deserve. That's exactly the wrong approach. No feedback is one the worst forms of disapproval; and the reason for the lack of feedback doesn't matter. > If you want to help accelerate the process then the door is open. So noted. > That's a separate discussion, and one I'll follow up on with Alex. I > think it's a very bad idea to have translations with different content > in them. This isn't a "My documentation is better than yours" contest. No, it's a question of available ressources and priorities. And for me, the German translation has (surprise, surprise) the higher priority. Changing my opinion on this topic is rather impossible. > Just because the stylesheet > *default* is to use the mnemonics doesn't mean that we have to go with the > default. I do not think that hacking the stylesheets until they bleed is a good idea. You're creating an additional hurdle for new contributors: The docbook reference says that using the bibliography markup gives you mnemonics and a seperate bibliography page. And now they work on FreeBSD documentation and suddenly everything is different. Change the document font, the font size, the adjustment, fine. Add a header or a footer, sure. Add http meta tags, all right. But wholesale hacks like this? /me shudders. Just imagine somebody would use the same approach for the source code: "Yeah, we know that the C standard uses { } for blocks and [ ] for arrays. We've decided to swap that." > But so far I've had no comments on the patches I've sent to the > mailing list. I rest my case. /s/Udo -- Cocaine is nature's way of telling you you have too much money. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message