Skip to content

Add documentation for the API #119

Closed

Description

@jaraco

In GitLab by @pradyunsg on Apr 16, 2020, 16:17

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.

Activity

  1. jaraco commented on Oct 22, 2020

    @jaraco
    MemberAuthor

    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?

  2. added
    documentationImprovements or additions to documentation
    enhancementNew feature or request
    help wantedExtra attention is needed
    on Jan 10, 2021
  3. jaraco commented on Apr 18, 2021

    @jaraco
    MemberAuthor

    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.

  4. added a commit that references this issue on May 18, 2021
    59cae40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or requesthelp wantedExtra attention is needed

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions