Fred L. Drake, Jr. added the comment: Provisional status should not cause a module or other API element to be omitted from the indexes. So long as it's marked provisional where it's described, it should be locatable. ---------- nosy: +fdrake _______________________________________ Python tracker https://bugs.python.org/issue37741 _______________________________________

Karthikeyan Singaravelan added the comment: Including a module directive with synopsis as below in importlib.metadata.rst seems to fix this. It would also be good to include a link to source code from the importlib.metadata docs page since it's written in Python. .. module:: importlib.metadata :synopsis: The implementation of the importlib metadata. **Source code:** :source:`Lib/importlib/metadata/__init__.py` ---------- nosy: +xtreak _______________________________________ Python tracker https://bugs.python.org/issue37741 _______________________________________

Jason R. Coombs added the comment:

Why is the code in `Lib/importlib/metadata/__init__.py`

Mainly because originally, the code was in multiple modules. I'm happy for it to move into a single file module. ---------- _______________________________________ Python tracker https://bugs.python.org/issue37741 _______________________________________

Change by miss-islington : ---------- pull_requests: +14889 pull_request: https://github.com/python/cpython/pull/15154 _______________________________________ Python tracker https://bugs.python.org/issue37741 _______________________________________

Miro Hrončok added the comment: The docs at https://docs.python.org/3/library/importlib.metadata.html also don't list the API at all, it is just a tutorial, not a reference. I see the code has docstrings, but they are missing from the docs. E.g. PackageNotFoundError is not documented at all. ---------- nosy: +hroncok _______________________________________ Python tracker https://bugs.python.org/issue37741 _______________________________________

Barry A. Warsaw added the comment: I'd still like to. I'm also happy to review any PRs if someone beats me to it. ---------- _______________________________________ Python tracker https://bugs.python.org/issue37741 _______________________________________

miss-islington added the comment: New changeset 23acadcc1c75eb74b2459304af70d97a35001b34 by Jason R. Coombs in branch 'master': bpo-37741: make importlib.metadata docs discoverable through a module directive. (GH-25415) https://github.com/python/cpython/commit/23acadcc1c75eb74b2459304af70d97a350... ---------- nosy: +miss-islington _______________________________________ Python tracker https://bugs.python.org/issue37741 _______________________________________

Change by miss-islington : ---------- pull_requests: +24149 pull_request: https://github.com/python/cpython/pull/25418 _______________________________________ Python tracker https://bugs.python.org/issue37741 _______________________________________

miss-islington added the comment: New changeset a746fceb7548e92f58037d9f90b5468bdc76889d by Miss Islington (bot) in branch '3.8': bpo-37741: make importlib.metadata docs discoverable through a module directive. (GH-25415) https://github.com/python/cpython/commit/a746fceb7548e92f58037d9f90b5468bdc7... ---------- _______________________________________ Python tracker https://bugs.python.org/issue37741 _______________________________________