[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