Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add a discussion on distribution packages vs. import packages #1425

Closed
jeanas opened this issue Dec 1, 2023 · 0 comments · Fixed by #1426
Closed

Add a discussion on distribution packages vs. import packages #1425

jeanas opened this issue Dec 1, 2023 · 0 comments · Fixed by #1426
Assignees
Labels
component: discussions diataxis: explanation Understanding oriented discussion (https://diataxis.fr/explanation/)

Comments

@jeanas
Copy link
Contributor

jeanas commented Dec 1, 2023

PR #1424 as well as this comment from @willingc make me think that it would be nice to have a discussion document on the difference between distribution packages and import packages. These terms are already explained in the glossary, but with few details and quite technical language.

This could cover: the terminology; the fact that distribution packages can have names with - and . in them, unlike import packages which (in 99.999% of cases) have Python identifiers as names; the fact that usually but not always, a distribution package contains a single import package with the same name (except - possibly replaced with _).

I'm going to take a stab at this.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
component: discussions diataxis: explanation Understanding oriented discussion (https://diataxis.fr/explanation/)
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants