Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Clarify documentation for the wheel specification #1924

Copy link
Copy link
@mihaigiurgeanu

Description

@mihaigiurgeanu
Issue body actions

Issue Description

I find the documentation extremely hard to read and time consuming. Very badly written.

Examples:

  • In Binary Distribution Format section, Details chapter is before File Format chapter, making forward references to distribution-1.0.dist-info/WHEEL, distribution-1.0.data/. Some things are not defined at all, like what is purelib, what is patlib?

  • In Overview of the Python Packaging, there is so little about the actual source and binary packaging and so much about Packaging Python applications. Packaging Python applications is just a discussion and its place should be in a Anexa or something, and not wasting reader's time with useless information.

How should documentation be improved

  1. No forward references
  2. Be concise and precise.
  3. Move discussions to separate sections. There is a discussion section, but a lot of useless text for the reader is into the overview section as well.

Code of Conduct

  • I am aware that participants in this repository must follow the PSF Code of Conduct.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions

      Morty Proxy This is a proxified and sanitized view of the page, visit original site.