.. toctree:: :maxdepth: 2 :hidden: overview flow tutorials/index guides/index discussions/index specifications/index key_projects glossary support contribute news
Welcome to the Python Packaging User Guide, a collection of tutorials and references to help you distribute and install Python packages with modern tools.
This guide is maintained on GitHub by the :doc:`Python Packaging Authority <pypa:index>`. We happily accept :doc:`contributions and feedback <contribute>`. 😊
Note
Building your understanding of Python packaging is a journey. Patience and continuous improvement are key to success. The overview and flow sections provide a starting point for understanding the Python packaging ecosystem.
The :doc:`overview` explains Python packaging and its use when preparing and distributing projects. This section helps you build understanding about selecting the tools and processes that are most suitable for your use case. It includes what packaging is, the problems that it solves, and key considerations.
To get an overview of the workflow used to publish your code, see :doc:`packaging flow <flow>`.
Tutorials walk through the steps needed to complete a project for the first time. Tutorials aim to help you succeed and provide a starting point for future exploration. The :doc:`tutorials/index` section includes:
- A :doc:`tutorial on installing packages <tutorials/installing-packages>`
- A :doc:`tutorial on managing application dependencies <tutorials/managing-dependencies>` in a version controlled project
- A :doc:`tutorial on packaging and distributing <tutorials/packaging-projects>` your project
Guides provide steps to perform a specific task. Guides are more focused on users who are already familiar with Python packaging and are looking for specific information.
The :doc:`guides/index` section provides "how to" instructions in three major areas: package installation; building and distributing packages; miscellaneous topics.
The :doc:`discussions/index` section for in-depth explanations and discussion about topics, such as:
- The :doc:`specifications/index` section for packaging interoperability specifications.
- The list of :doc:`other projects <key_projects>` maintained by members of the Python Packaging Authority.
- The :doc:`glossary` for definitions of terms used in Python packaging.