[New-bugs-announce] [issue31799] Improve __spec__ discoverability

Barry A. Warsaw report at bugs.python.org
Mon Oct 16 10:16:27 EDT 2017

New submission from Barry A. Warsaw <barry at python.org>:

__spec__ is defined in PEP 451.  If you search for "__spec__" in the docs, you get a number of hits.


Click on the first link:


but that still leaves you scratching your head as to what exactly is in __spec__.  If you happen to scroll up a little bit though, you end up here:


and then if you follow the link to ModuleSpec, you finally get to here:


and *that's* where the contents of __spec__ are defined.  Not very discoverable.

I propose just a couple of small documentation fixes to add "__spec__" in both of those locations so that a search lands you in a useful place.

assignee: barry
components: Documentation
messages: 304474
nosy: barry
priority: normal
severity: normal
status: open
title: Improve __spec__ discoverability
versions: Python 3.4, Python 3.5, Python 3.6, Python 3.7

Python tracker <report at bugs.python.org>

More information about the New-bugs-announce mailing list