(original) (raw)

re: docs hg repos and static HTTP hosting

\* I can't remember what the GitHub Pages CDN cache time is
\* Does BitBucket support more than one pages repo?
\* Does support Sphinx .. index and :ref: syntax extensions?

\* https://github.com/yoloseem/awesome-sphinxdoc
\* https://github.com/rtfd/readthedocs.org ("hostthedocs")
\* http://conf.writethedocs.org/
\* https://docs.python.org/devguide/documenting.html

On Sat, Nov 22, 2014 at 11:19 PM, Guido van Rossum <guido@python.org> wrote:
This thread seems to beg for a decision. I think Donald Stufft has it exactly right: we should move to GitHub, because it is the easiest to use and most contributors already know it (or are eager to learn thee). Honestly, the time for core devs (or some other elite corps of dedicated volunteers) to sysadmin their own machines (virtual or not) is over. We've never been particularly good at this, and I don't see us getting better or more efficient.

Moving the CPython code and docs is not a priority, but everything else (PEPs, HOWTOs etc.) can be moved easily and I am in favor of moving to GitHub. For PEPs I've noticed that for most PEPs these days (unless the primary author is a core dev) the author sets up a git repo first anyway, and the friction of moving between such repos and the "official" repo is a pain.

--
--Guido van Rossum (python.org/\~guido)

\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_
Python-Dev mailing list
Python-Dev@python.org
https://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: https://mail.python.org/mailman/options/python-dev/wes.turner%40gmail.com




--
Wes Turner
https://westurner.github.io/