[Numpy-discussion] ANN: NumPy/SciPy Documentation Marathon 2008

[Robert Kern]

On Wed, May 21, 2008 at 1:27 AM, Pauli Virtanen <pav at iki.fi> wrote:

> I think it would be quite straightforward to write a function that
> crawled over the numpy namespace and dynamically replaced __doc__ with
> gettextized versions. The user could call this function to switch the
> language and the reference manual authors could call it to produce
> localized versions of the manual. Moreover, we already have tools to
> extract English docstrings from numpy and producing .pot files for
> gettext could be done. I think i18n of numpy (or any other Python
> module) is technically not as far out as it initially seems!

Yes, that sounds (technically) feasible.

> (This is assuming that there are no objects there that don't allow
> changing their __doc__.)
>
> But I believe that in practice, we really had better to concentrate on
> improving the documentation in English before thinking about spending
> much effort on i18n or l10n.

Yup. Sounds about right.

-- 
Robert Kern

"I have come to believe that the whole world is an enigma, a harmless
enigma that is made terrible by our own mad attempt to interpret it as
though it had an underlying truth."
 -- Umberto Eco