diff options
author | Saniya Maheshwari <saniya.mah@gmail.com> | 2022-06-23 11:18:31 +0530 |
---|---|---|
committer | Saniya Maheshwari <saniya.mah@gmail.com> | 2022-06-23 11:27:28 +0530 |
commit | 369f10f56de2cde596eaef35e17209276302457e (patch) | |
tree | d4d11832aa62227a3624908ebf44ff9146f4c263 | |
parent | 0bd847c4aea839b3a75f4e3f09a36526453bd267 (diff) | |
download | python-setuptools-git-369f10f56de2cde596eaef35e17209276302457e.tar.gz |
Reorganized the User Guide's Table of Contents
This mostly follows the scheme given
[here](https://github.com/pypa/setuptools/discussions/3400#discussioncomment-3003334),
with the following exceptions:
- "Controlling files in the distribution" is kept not immediately after
the "Package Discovery" page, but rather towards the end, because a
lot of the material in that page overlaps with material given in the
"Package Discovery" and "Data Files" pages. Therefore, it seems to me
that this page should be read _after_ the other two pages have been
read.
- "Development Mode" is kept not towards the end but introduced close
to the beginning, because readers might want to start using it early
on in their projects.
- "Building Extension Modules" is kept immediately after the "Entry
Points" and "Data Files" pages, since it is the last major topic we
would like to discuss. The two topics that follow ("Specifying your
Project's Version" and "Controlling Files in the Distribution") are
lighter topics.
- Have retained the pages "Extending or Customizing Setuptools",
"Configuring Setuptools using setup.cfg files" and "Configuring
Setuptools using pyproject.toml files" for now.
-rw-r--r-- | docs/userguide/index.rst | 8 |
1 files changed, 4 insertions, 4 deletions
diff --git a/docs/userguide/index.rst b/docs/userguide/index.rst index c928f02f..e1563c91 100644 --- a/docs/userguide/index.rst +++ b/docs/userguide/index.rst @@ -26,16 +26,16 @@ Contents quickstart package_discovery - entry_point dependency_management - ext_modules - datafiles development_mode + entry_point + datafiles + ext_modules distribution + miscellaneous extension declarative_config pyproject_config - miscellaneous --- |