Date: Thu, 15 Mar 2001 20:03:37 +0100 From: Udo Erdelhoff <ue@nathan.ruhr.de> To: doc@FreeBSD.org Subject: Re: Translators: Need feedback on FAQ reorganization Message-ID: <20010315200337.N83336@nathan.ruhr.de> In-Reply-To: <20010315023806.B46684@canyon.nothing-going-on.org>; from nik@freebsd.org on Thu, Mar 15, 2001 at 02:38:06AM %2B0000 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>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010315200337.N83336>