<div dir="ltr"><br><br><div class="gmail_quote"><div dir="ltr">On Fri, 26 May 2017 at 21:28 Nick Coghlan <<a href="mailto:ncoghlan@gmail.com">ncoghlan@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi folks,<br>
<br>
Over on <a href="https://github.com/pypa/python-packaging-user-guide/pull/305#issuecomment-304169735" rel="noreferrer" target="_blank">https://github.com/pypa/python-packaging-user-guide/pull/305#issuecomment-304169735</a><br>
we're looking to update the theming of <a href="http://packaging.python.org" rel="noreferrer" target="_blank">packaging.python.org</a> to match<br>
that of the language documentation at <a href="http://docs.python.org" rel="noreferrer" target="_blank">docs.python.org</a>.<br>
<br>
Doing that would also entail updating the documentation of the<br>
individual tools and services (pip, pypi, setuptools, wheel, etc) to<br>
maintain consistency with the main packaging user guide, so Jon has<br>
tentatively broken the theme out as a (not yet published anywhere)<br>
"pypa-theme" package to make it easier to re-use across multiple<br>
projects.<br>
<br>
The question that occurred to me is whether or not it might make more<br>
sense to instead call that package "psf-docs-theme", to reflect that<br>
it's intended specifically for projects that are legally backed by the<br>
PSF, and that general Python projects looking for a nice,<br>
high-contrast, theme should consider using an org independent one like<br>
Alabaster instead.<br>
<br>
Thoughts? Should we stick with pypa-theme as the name? Switch to<br>
psf-docs-theme? Publish both, with pypa-theme adding PyPA specific<br>
elements to a more general psf-docs-theme?<br></blockquote><div><br></div><div>If we're going to share the theme beyond <a href="http://docs.python.org">docs.python.org</a> it makes sense to have a shared theme under the Python org that can easily be reused by multiple sets of documentation.</div><div><br></div><div>As for the name, the psf-docs-theme seems fine with me.</div><div><br></div><div>-Brett</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
Cheers,<br>
Nick.<br>
<br>
P.S. In case folks aren't aware of the full legal arrangements here:<br>
in addition to the informal "Python Packaging Authority" designation,<br>
there's also a formally constituted PSF Packaging Working Group that<br>
provides the legal connection back to the PSF. That means the<br>
relationship between PyPA and the PSF ends up being pretty similar to<br>
the one between python-dev and the PSF, where there's no direct PSF<br>
involvement in day to day development activities, but the PSF provides<br>
the legal and financial backing needed to sustainably maintain popular<br>
community-supported software and services.<br>
<br>
Part of my rationale for suggesting the inclusion of "psf" in the<br>
package name is to make it clear that the intent would be to create a<br>
clear and distinctive "trade dress" for the documentation of directly<br>
PSF backed projects:<br>
<a href="https://en.wikipedia.org/wiki/Trade_dress#Protection_for_electronic_interfaces_and_websites" rel="noreferrer" target="_blank">https://en.wikipedia.org/wiki/Trade_dress#Protection_for_electronic_interfaces_and_websites</a><br>
<br>
Future requests to use the theme (beyond CPython and the PyPA) could<br>
then be run through the PSF Trademarks committee, as with requests to<br>
use the registered marks.<br>
<br>
Whereas if we go with pypa-theme, then that would just be a<br>
non-precedent-setting agreement between PyPA and CPython to share a<br>
documentation theme, without trying to define any form of<br>
documentation trade dress for the PSF in general.<br>
<br>
--<br>
Nick Coghlan | <a href="mailto:ncoghlan@gmail.com" target="_blank">ncoghlan@gmail.com</a> | Brisbane, Australia<br>
_______________________________________________<br>
Python-Dev mailing list<br>
<a href="mailto:Python-Dev@python.org" target="_blank">Python-Dev@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/python-dev" rel="noreferrer" target="_blank">https://mail.python.org/mailman/listinfo/python-dev</a><br>
Unsubscribe: <a href="https://mail.python.org/mailman/options/python-dev/brett%40python.org" rel="noreferrer" target="_blank">https://mail.python.org/mailman/options/python-dev/brett%40python.org</a><br>
</blockquote></div></div>