Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 01 Apr 1998 00:58:04 -0800
From:      "Jordan K. Hubbard" <jkh@time.cdrom.com>
To:        nik@iii.co.uk
Cc:        dannyman <dannyman@sasquatch.dannyland.org>, Jun Kuriyama <kuriyama@opt.phys.waseda.ac.jp>, freebsd-doc@FreeBSD.ORG, committers@FreeBSD.ORG, nik@FreeBSD.ORG
Subject:   Re: Move handbook to doc/en/handbook as part of DTD migration? (was Re: LINUXDOC_2_DOCBOOK_BP branch applied to doc/handbook) 
Message-ID:  <26597.891421084@time.cdrom.com>
In-Reply-To: Your message of "Wed, 01 Apr 1998 09:23:24 %2B0100." <19980401092324.11179@iii.co.uk> 

next in thread | previous in thread | raw e-mail | index | archive | help
> I think it does make sense for there to be one 'canonical' version of the
> Handbook from which all other translations are derived. So far, that's
> the English version, and will probably continue to be, if for no other

I am of two opinions on this one.  One opinion says that if there are
some Japanese folks (just for example) who have some *great* ideas for
improving the Japanese FAQ & Handbook but can only apply these ideas
to the Japanese version then those ideas should not be held back just
on account of the english version.  Our docs situation is bad enough
without making the situation worse by being inflexibly wedded to some
syncronization model.

The other opinion says that without a reasonably canonical version of
these docs, chaos can be the only eventual result and we'll also be
depriving ourselves of a decent body of english-language documentation
which has far more international value (as a "lingua franca" ;-) than
any of the translated versions.

I guess the only practical approach to take here is a pragmatic one,
considering how few volunteers we have for docs.  If we can get folks
to improve *any* of the docs significantly beyond what we have now, we
take it regardless of the language.  If we can also get folks to
understand the importance of the english docs, hopefully so much so
that they put significant work into making the english docs a better
"template version" for all their own work (my fondest wish, you see),
then we'll have won the game.

					Jordan

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?26597.891421084>