You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
It'd be great to have API reference documentation, like https://packaging.pypa.io/en/latest/version/#reference for importlib.metadata. It'd be nice to know exactly what functions, classes, attributes, and methods are publicly available for various bits of functionality provided by this project.
Yes, I agree. The existing docs do enumerate most of the supported functions and classes, but it reads more like a manual than a reference. I'd be open to adding a reference to the source to document the supported API. Would you be willing to draft a MR?
In my other projects, I rely heavily on autodoc. I'd be more than happy to include that in reference documentation, but I'm not sure how well that's supported in CPython (with which this project attempts to stay in sync). In the bpo-37741, this issue was addressed for CPython by simply linking to the source. Perhaps this project could do the same.
Activity
jaraco commentedon Oct 22, 2020
In GitLab by @jaraco on Jun 5, 2020, 15:46
Yes, I agree. The existing docs do enumerate most of the supported functions and classes, but it reads more like a manual than a reference. I'd be open to adding a reference to the source to document the supported API. Would you be willing to draft a MR?
jaraco commentedon Apr 18, 2021
In my other projects, I rely heavily on autodoc. I'd be more than happy to include that in reference documentation, but I'm not sure how well that's supported in CPython (with which this project attempts to stay in sync). In the bpo-37741, this issue was addressed for CPython by simply linking to the source. Perhaps this project could do the same.
docs: add api reference