> Hello all,
> Given some recent -- ahem -- difficulties with matplotlib users where
> English is not their native language, it has dawned on me that maybe we
> ought to consider making available translated versions of our
> documentation. I have absolutely no experience with such efforts, but I did
> see that Sphinx does support internationalization:
a soft on this -1 from me. At this time, I feel that matplotlib has neither
the user base need, nor the developer / i18n expert bandwidth to make this
happen. As a point of reference, even the Python docs aren't
internationalized, at the moment.
> and I do believe we have some bilingual developers on this list (or at least
> are active on the users list). While I don't think it would be possible to
> translate the API docs effectively, at the very least we should be able to
> provide translations of other parts.
which parts? Tutorials? It seems like these sorts of things
self-organize around individuals who write about the software in
their language of choice. Folks searching the web for something
like "python publication quality graphics" in Esperanto or
Klingon will find one another, if there are enough of them, and
if there aren't enough of them, we'd have a very hard time
> What does everyone think? Could someone who has done internationalization
> (particularly using sphinx) comment? What languages would we like the docs
> to be in?
I think the fact that there isn't a language that automatically
pops into our heads suggests to me that we could expand a lot of
effort to do this without users that actually need it.
Darren Dale, on 2011-02-22 14:52, wrote:
If anyone is looking for me, I'll be cowering under my desk.
English being lingua franca is fairly typical in the software
world, but that doesn't mean we should feel free to sprinkle
idioms and confusing cultural references everywhere. I'm guilty
of both of these, as I sometimes try to add "color" to my
comments, which might produce a chuckle for the folks who
understood, but be a source of unneeded confusion for others.
So may I propose an alternative, which I've seen in somewhere
else, but completely blanking on where: add to our FAQ (or some
similar place) comment requesting feedback along these lines:
All of the documentation is in English: is there a
<insert-language> translation of matplotlib documentation?
We strive to make matplotlib accessible to everyone, but lack the
resource to translate and maintain the documentation in several
languages. Please help us identify and reword confusing portions
of the documentation (in particular, idiomatic or otherwise
untranslatable usage of English in docstrings is considered a
bug which you should report).
On Tue, Feb 22, 2011 at 2:45 PM, Benjamin Root <ben.root@...553...> wrote:
314 address only used for lists, off-list direct email at:
http://pirsquared.org | GPG/PGP key id: 0x0F3E28F7