[Distutils] Proposal: moving PyPA projects to pydoctheme

Jon Wayne Parrott jonwayne at google.com
Thu May 25 22:03:39 EDT 2017


o/ Hello everyone,
I've been working on the Packaging User Guide and various discussions have
come up about the theme (
https://github.com/pypa/python-packaging-user-guide/issues/304) as well as
the common brand for PyPA projects (
https://github.com/pypa/python-packaging-user-guide/issues/62).

I'm proposing we switch PyPA projects (namely pypa.io, PyPUG, distlib, pip,
setuptools, virtualenv, warehouse, and wheel) to match the upstream CPython
docs for Python 3 (referred to as "pydoctheme").

Switching from the current readthedocs theme has a couple of advantages:

* Higher contrast and sans-serif fonts means better readability and
accessibility.
* Consistency with Python re-enforces that these are "official"/"blessed"
tools & documentation.
* A central shared theme among these projects allows us to make consistent
identity modifications across projects easily.

This work has been started on PyPUG (
https://github.com/pypa/python-packaging-user-guide/pull/305#issuecomment-304169735).
I have staged a build of PyPUG using the new theme here (
http://temp.theadora.io/pypug-pydoctheme/index.html). Please take a look
and comment on github with any concerns, and by all means tell me I'm crazy
for trying to do this. :)

If the primary maintainers of these projects all agree, I will create the
theme package and submit PRs to all the projects to do this migration.
You'll only need to approve. From what I understand those people are
@dstufft, @pfmoore, @jaraco, @vsajip, @dholth, and @ncoglan, but please let
me know if I missed anyone (I'm still new!)

Thanks!
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/distutils-sig/attachments/20170526/3cc58ab5/attachment.html>


More information about the Distutils-SIG mailing list