[Distutils] Proposal: moving PyPA projects to pydoctheme

Donald Stufft donald at stufft.io
Fri May 26 07:20:14 EDT 2017


This looks fine to me.

> On May 25, 2017, at 10:03 PM, Jon Wayne Parrott via Distutils-SIG <distutils-sig at python.org> wrote:
> 
> 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 <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 <https://github.com/pypa/python-packaging-user-guide/issues/62>).
> 
> I'm proposing we switch PyPA projects (namely pypa.io <http://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 <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 <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!
> _______________________________________________
> Distutils-SIG maillist  -  Distutils-SIG at python.org
> https://mail.python.org/mailman/listinfo/distutils-sig


—
Donald Stufft



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


More information about the Distutils-SIG mailing list