| Store | Cart

Re: [Python-Dev] Translated Python documentation

From: Nick Coghlan <ncog...@gmail.com>
Sun, 26 Feb 2017 14:22:28 +1000
On 26 February 2017 at 05:57, INADA Naoki <song...@gmail.com> wrote:

> Yes, right place to discussion is one of important things what I want.> I haven't know about i18n-sig.  Is it better than docs-sig?>>> Another thing I want is agreement to use project name looks like> (semi)official project.>> We used "python-doc-jp" name on Transifex at first.  But since some people> other than Japanese ask me to allow other languages,  I renamed it to> "python-doc".> And I reserved "python-docs" organization at Github.>

+1 from me for continuing to use those names (although you may want to
standardise on "python-docs", since the mailing list is docs-sig, and the
site is docs.python.org).

While it's not translation related, I'll also note an idea that came up at
the language summit a couple of years ago: moving the tutorial and the
howto guides *out* of the version-specific documentation and into a
separate version independent docs repository. As the stats Serhiy posted
suggest, these typically *don't* change a great deal between versions, and
when they do, the version differences are often going to be better handled
inline (e.g. "On versions older than 3.x, ....") rather than by maintaining
multiple distinct versions of the document.

Cheers,
Nick.

-- 
Nick Coghlan   |   ncog...@gmail.com   |   Brisbane, Australia

_______________________________________________
Python-Dev mailing list
Pyth...@python.org
https://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: https://mail.python.org/mailman/options/python-dev/python-dev-ml%40activestate.com

Recent Messages in this Thread
Victor Stinner Feb 22, 2017 12:10 pm
Tres Seaver Feb 22, 2017 03:19 pm
Antoine Pitrou Feb 22, 2017 03:40 pm
Victor Stinner Feb 22, 2017 04:15 pm
Serhiy Storchaka Feb 22, 2017 06:04 pm
Facundo Batista Feb 22, 2017 07:20 pm
Victor Stinner Feb 22, 2017 09:01 pm
Berker Peksağ Feb 24, 2017 12:20 pm
INADA Naoki Feb 24, 2017 01:05 pm
Nick Coghlan Feb 24, 2017 02:33 pm
Rob Cliffe Feb 27, 2017 02:18 am
David Mertz Feb 27, 2017 04:03 am
Nick Coghlan Feb 27, 2017 07:30 am
David Mertz Feb 27, 2017 08:20 am
Victor Stinner Feb 27, 2017 10:58 am
Nick Coghlan Feb 24, 2017 10:02 am
trit...@sdamon.com Feb 24, 2017 11:01 am
Jim F.Hilliard Feb 24, 2017 11:15 am
INADA Naoki Feb 24, 2017 11:49 am
Brett Cannon Feb 25, 2017 06:19 pm
Ned Deily Feb 25, 2017 07:08 pm
INADA Naoki Feb 25, 2017 07:57 pm
Nick Coghlan Feb 26, 2017 04:22 am
Brett Cannon Feb 26, 2017 08:32 pm
Victor Stinner Feb 27, 2017 10:31 am
Ned Deily Mar 09, 2017 11:35 pm
Victor Stinner Mar 10, 2017 12:03 am
Victor Stinner Mar 22, 2017 12:46 am
Steven DAprano Feb 24, 2017 03:10 pm
MRAB Feb 24, 2017 06:54 pm
Nick Coghlan Feb 25, 2017 06:46 am
Nick Coghlan Feb 25, 2017 06:32 am
Victor Stinner Feb 27, 2017 11:04 am
Xiang Zhang Feb 28, 2017 10:00 am
Jim F.Hilliard Feb 24, 2017 11:12 am
Facundo Batista Feb 22, 2017 05:58 pm
Messages in this thread