<feed xmlns='http://www.w3.org/2005/Atom'>
<title>delta/python-setuptools-git.git/docs/userguide/index.rst, branch v63.4.2</title>
<subtitle>github.com: pypa/setuptools.git
</subtitle>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/'/>
<entry>
<title>fix userguide typo</title>
<updated>2022-07-01T06:56:29+00:00</updated>
<author>
<name>Matthias Jansen</name>
<email>m.jansen@accure.net</email>
</author>
<published>2022-07-01T06:56:29+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=55fd336ba81df83174202d1f0cfb15722074084a'/>
<id>55fd336ba81df83174202d1f0cfb15722074084a</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Reorganized the User Guide's Table of Contents</title>
<updated>2022-06-23T05:57:28+00:00</updated>
<author>
<name>Saniya Maheshwari</name>
<email>saniya.mah@gmail.com</email>
</author>
<published>2022-06-23T05:48:31+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=369f10f56de2cde596eaef35e17209276302457e'/>
<id>369f10f56de2cde596eaef35e17209276302457e</id>
<content type='text'>
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.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
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.
</pre>
</div>
</content>
</entry>
<entry>
<title>[Docs] Move command description to the deprecated practice section (#3371)</title>
<updated>2022-06-14T16:27:30+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri@gmail.com</email>
</author>
<published>2022-06-14T16:27:30+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=94955ceb80945f5b9880545030db1de7a539c38f'/>
<id>94955ceb80945f5b9880545030db1de7a539c38f</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Merge docs on deprecated commands</title>
<updated>2022-06-14T14:02:38+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri@gmail.com</email>
</author>
<published>2022-06-14T14:00:38+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=6850040693db9e3edc4238c1fa4aa458aacaaa9b'/>
<id>6850040693db9e3edc4238c1fa4aa458aacaaa9b</id>
<content type='text'>
Also add a not about modern ways of generating ``sdists`` and ``wheel``.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Also add a not about modern ways of generating ``sdists`` and ``wheel``.
</pre>
</div>
</content>
</entry>
<entry>
<title>docs/userguide/ext_modules.rst: Add more specifics about Extension attributes</title>
<updated>2022-06-14T09:29:51+00:00</updated>
<author>
<name>Matthias Koeppe</name>
<email>mkoeppe@math.ucdavis.edu</email>
</author>
<published>2022-06-13T20:44:34+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=adfe9c3c54e81cfd14b59e31e43673d81cb8a055'/>
<id>adfe9c3c54e81cfd14b59e31e43673d81cb8a055</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Doc improvements (#3363, #3364, #3367)</title>
<updated>2022-06-13T08:45:07+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri@gmail.com</email>
</author>
<published>2022-06-13T08:45:07+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=43b515b7b5f27ac2aad70d93320f49478782deed'/>
<id>43b515b7b5f27ac2aad70d93320f49478782deed</id>
<content type='text'>
- Improve docs by avoiding confusion with distutils
- Update dependency management docs
- Update userguide on miscellaneous and extension
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
- Improve docs by avoiding confusion with distutils
- Update dependency management docs
- Update userguide on miscellaneous and extension
</pre>
</div>
</content>
</entry>
<entry>
<title>Remove unused parts</title>
<updated>2022-06-13T08:08:40+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri@gmail.com</email>
</author>
<published>2022-06-13T08:08:40+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=fd19ae6b54751bf0a01ddb3cc47b008d348f483c'/>
<id>fd19ae6b54751bf0a01ddb3cc47b008d348f483c</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Improve docs by avoiding confusion with distutils</title>
<updated>2022-06-12T11:59:01+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri@gmail.com</email>
</author>
<published>2022-06-12T11:32:31+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=8e72d24832c9c94108e404d368ee09685630cbe8'/>
<id>8e72d24832c9c94108e404d368ee09685630cbe8</id>
<content type='text'>
The existing docs seem to assume that the user is familiar with the
history of packaging in the Python ecosystem (or at least know what is
`distutils`).

Since that is not always the case and that `distutils` is in the process
of being adopted by `setuptools`, the documentation should be changed
to minimize mentions to `distutils` and avoid expecting too much
knowledge from the users.

The benefit of this approach is that it can make the docs more
accessible and easier to understand.

Changes:

- Modify landing page to clarify what `setuptools` does (making it more
  clear to understand for beginners).
- Remove mentions to `distutils`, `transition to PEP 517` from
  `userguide/index`.
  - Instead the text is changed to have a more "introductory" tone.
- Remove mentions to `distutils` from the Quickstart.
- Remove `python2` from the intersphinx mapping - it was causing trouble
  redirecting glossary terms to Python2 docs, instead of Python3.
- Modify documentation about development mode to be more aligned with
  current practices (i.e. using `pip install -e .`)
  - In this process all documentation about running `setuptools` commands
    in `distutils` projects was moved to a new file in `docs/deprecated/running_commands.rst`
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
The existing docs seem to assume that the user is familiar with the
history of packaging in the Python ecosystem (or at least know what is
`distutils`).

Since that is not always the case and that `distutils` is in the process
of being adopted by `setuptools`, the documentation should be changed
to minimize mentions to `distutils` and avoid expecting too much
knowledge from the users.

The benefit of this approach is that it can make the docs more
accessible and easier to understand.

Changes:

- Modify landing page to clarify what `setuptools` does (making it more
  clear to understand for beginners).
- Remove mentions to `distutils`, `transition to PEP 517` from
  `userguide/index`.
  - Instead the text is changed to have a more "introductory" tone.
- Remove mentions to `distutils` from the Quickstart.
- Remove `python2` from the intersphinx mapping - it was causing trouble
  redirecting glossary terms to Python2 docs, instead of Python3.
- Modify documentation about development mode to be more aligned with
  current practices (i.e. using `pip install -e .`)
  - In this process all documentation about running `setuptools` commands
    in `distutils` projects was moved to a new file in `docs/deprecated/running_commands.rst`
</pre>
</div>
</content>
</entry>
<entry>
<title>Move userguide/keywords to deprecated/changed_keyworkds</title>
<updated>2022-05-06T11:46:54+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri@gmail.com</email>
</author>
<published>2022-05-06T11:46:54+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=094809b515b38940a8cd015633d815ec0f18b83d'/>
<id>094809b515b38940a8cd015633d815ec0f18b83d</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Add initial docs about pyproject.toml metadata</title>
<updated>2022-03-16T16:26:25+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri@gmail.com</email>
</author>
<published>2022-03-14T00:48:38+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=dcb136115373df161af02ec3d32aa97e38523742'/>
<id>dcb136115373df161af02ec3d32aa97e38523742</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
</feed>
