[Python-ideas] Cross link documentation translations

[Alexander Walters]

I am -1 for linking the official documentation to anything not on 
docs.python.org (or to things like the source listings link on the 
library docs, which is controlled by the same party as controls the 
documentation).  It irks me every time I see a link to activestate 
recipes in the official docs.  Activestate has already taken down 
documentation they have previously hosted, and the recipes will only 
exist as long as it is advantageous to them to continue hosting them*.  
The same can be said of translation projects that don't exist as special 
interest groups under the PSF.

But I do like the idea of linking to translations.  Would it not be a 
better solution to try and unify the translation efforts into one system 
as SIGs of the Doc-SIG?

Besides, linking only to documentation you generate (as hosting the docs 
as a sig under the doc-sig would allow) would make the technical 
implementation much easier.

Baring that, its a better-than-nothing idea.







* not to mention the questionable quality of the recipes.

On 1/24/2016 05:35, Julien Palard wrote:
> o/
>
> While translating the Python Documentation in French [1][2], I 
> discovered that we're not the only country doing it, there is also 
> Japan [3][4], and Spain [5]. It's possible there's other but I didn't 
> find them (and it's the problem).
>
> But there's only a few way for users to find the translations (hearing 
> about them, or explicitly searching for them on a search engine, which 
> they won't do, obviously expecting a link from the english version if 
> they exists).
>
> So here is my idea: Why not linking translations from the main 
> documentation?
>
> I know that's not directly supported by Sphinx doc [6], but separate 
> sphinx build, blindly (with hardcoded links) linking themselves, may 
> work (like readthedoc is probably doing). The downside of those links 
> is that we'll sometime link to untranslated parts, but those parts may 
> be marked as untranslated [7] to encourage new translators to help.
>
> Thoughts?
>
> [1] http://www.afpy.org/doc/python/3.5/
> [2] https://github.com/afpy/python_doc_fr
> [3] http://docs.python.jp/3/
> [4] https://github.com/python-doc-ja/python-doc-ja
> [5] http://docs.python.org.ar/tutorial/3/index.html
> [6] https://github.com/sphinx-doc/sphinx/issues/2252
> [7] https://github.com/sphinx-doc/sphinx/issues/1246
>