<div dir="ltr"><br><br><div class="gmail_quote"><div dir="ltr">On Mon, 30 Jan 2017 at 07:16 Berker Peksağ <<a href="mailto:berker.peksag@gmail.com">berker.peksag@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On Mon, Jan 30, 2017 at 12:21 PM, INADA Naoki <<a href="mailto:songofacandy@gmail.com" class="gmail_msg" target="_blank">songofacandy@gmail.com</a>> wrote:<br class="gmail_msg">
> There are some updates about this topic.<br class="gmail_msg">
>  And I have something to discuss to get things forward.<br class="gmail_msg">
><br class="gmail_msg">
> We (Japanese translation team) and Julien start sharing one Transifex project.<br class="gmail_msg">
> Please see this dashboard.  We have nice progress.<br class="gmail_msg">
> <a href="https://www.transifex.com/python-doc/python-35/dashboard/" rel="noreferrer" class="gmail_msg" target="_blank">https://www.transifex.com/python-doc/python-35/dashboard/</a><br class="gmail_msg">
><br class="gmail_msg">
> Julien want hosting french documentation at <a href="https://docs.python.org/fr/" rel="noreferrer" class="gmail_msg" target="_blank">https://docs.python.org/fr/</a><br class="gmail_msg">
> I don't have strong opinion about where to hosting, but I want to share<br class="gmail_msg">
> more efforts (automated build + hosting) with Julien and other language<br class="gmail_msg">
> communities.<br class="gmail_msg">
><br class="gmail_msg">
> Since Berker Peksag against about hosting translated document on<br class="gmail_msg">
> <a href="http://docs.python.org" rel="noreferrer" class="gmail_msg" target="_blank">docs.python.org</a> [1], I'm considering about using github pages.<br class="gmail_msg">
><br class="gmail_msg">
> I got "python-docs" organization already for it [2].  So translated documents<br class="gmail_msg">
> can be hosted on URL like <a href="https://python-docs.github.io/py35-ja/" rel="noreferrer" class="gmail_msg" target="_blank">https://python-docs.github.io/py35-ja/</a> or<br class="gmail_msg">
> <a href="https://python-docs.github.io/py35/fr/" rel="noreferrer" class="gmail_msg" target="_blank">https://python-docs.github.io/py35/fr/</a> .  (first part of the path<br class="gmail_msg">
> should be same to<br class="gmail_msg">
> repository name).<br class="gmail_msg">
><br class="gmail_msg">
> I already uses github pages for testing Japanese translation [3].<br class="gmail_msg">
> It's nice place to host webpage.  We can get https and CDN for free.<br class="gmail_msg">
><br class="gmail_msg">
> [1]: <a href="https://github.com/python/docsbuild-scripts/pull/8" rel="noreferrer" class="gmail_msg" target="_blank">https://github.com/python/docsbuild-scripts/pull/8</a><br class="gmail_msg">
> [2]: <a href="https://github.com/python-docs" rel="noreferrer" class="gmail_msg" target="_blank">https://github.com/python-docs</a><br class="gmail_msg">
> [3]: <a href="https://python-doc-ja.github.io/py35/" rel="noreferrer" class="gmail_msg" target="_blank">https://python-doc-ja.github.io/py35/</a><br class="gmail_msg">
><br class="gmail_msg">
><br class="gmail_msg">
> So I want to discuss (and get consensus) about where should we host<br class="gmail_msg">
> translated document.<br class="gmail_msg">
><br class="gmail_msg">
> a) translated docs on <a href="http://docs.python.org" rel="noreferrer" class="gmail_msg" target="_blank">docs.python.org</a> / issue tracker on <a href="http://github.com/python-docs/" rel="noreferrer" class="gmail_msg" target="_blank">github.com/python-docs/</a><br class="gmail_msg">
> b) translated docs on <a href="http://python-docs.github.io" rel="noreferrer" class="gmail_msg" target="_blank">python-docs.github.io</a> / issue tracker on<br class="gmail_msg">
> <a href="http://github.com/python-docs/" rel="noreferrer" class="gmail_msg" target="_blank">github.com/python-docs/</a><br class="gmail_msg">
<br class="gmail_msg">
+1 for b) or any idea that would indicate that the Python developers<br class="gmail_msg">
don't maintain translations of the official documentation. I don't<br class="gmail_msg">
have a strong opinion on naming the GitHub organization (maybe<br class="gmail_msg">
python-docs-translations?) but that can be discussed later. Another<br class="gmail_msg">
advantage of this approach is that you can have separate issue<br class="gmail_msg">
trackers for each language (e.g. python-docs-fr) so people can easily<br class="gmail_msg">
report documentation issues in their native languages.<br class="gmail_msg"></blockquote><div><br></div><div>Does hosting on Read the Docs makes any of this easier/harder? </div></div></div>