Skip to content

[Docs] Clarify version number conventions wrt PEP440 #3419

Closed
@cdfarrow

Description

@cdfarrow
Contributor

Summary

The setuptools' Version page gives a lot of example schemes that are not PEP440 compliant. I followed that page to create a post-release version number, but then it was rejected by PyPI. The page mentions PEP440 in passing in the opening paragraph, but it would be more helpful to explain that for certain situations (e.g. uploading to PyPI; what else?) PEP440 must be followed.

OS / Environment

No response

Additional Information

This would direct readers straight to the correct/recommended conventions rather than wasting their time reading irrelevant information.

Code of Conduct

  • I agree to follow the PSF Code of Conduct

Activity

added a commit that references this issue on Oct 6, 2022

Fix pypa#3419. Update example versions to be PEP440-compliant

0d2bcd8
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

    Needs TriageIssues that need to be evaluated for severity and status.documentation

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

      Development

      Participants

      @cdfarrow

      Issue actions

        [Docs] Clarify version number conventions wrt PEP440 · Issue #3419 · pypa/setuptools