<feed xmlns='http://www.w3.org/2005/Atom'>
<title>delta/python-setuptools-git.git/docs/userguide/quickstart.rst, branch v63.3.0</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>type in quickstart.rst</title>
<updated>2022-07-29T09:41:21+00:00</updated>
<author>
<name>Edgar Riba</name>
<email>edgar.riba@gmail.com</email>
</author>
<published>2022-07-29T09:41:21+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=60c555112b328b90b59e5f4d8a94a0e2207f9817'/>
<id>60c555112b328b90b59e5f4d8a94a0e2207f9817</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Fix typo `find_namespaces:` to `find_namespace:`</title>
<updated>2022-07-25T06:07:35+00:00</updated>
<author>
<name>Brody Rampono</name>
<email>64628500+brampono@users.noreply.github.com</email>
</author>
<published>2022-07-25T06:07:35+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=ba7db83ae7080979cbb650f3efb74373544589a5'/>
<id>ba7db83ae7080979cbb650f3efb74373544589a5</id>
<content type='text'>
I believe the correct `setup.cfg` packaging option is `find_namespace:`, not `find_namespaces:`
I can't find any other references to `find_namespaces` in the docs or repository.

Using `find_namespaces:` causes packaging to fail. Example to reproduce:
```
.
├── pyproject.toml
├── setup.cfg
└── src
    ├── pkg1
    │   └── namespace
    │       └── __init__.py
    └── pkg2
        └── __init__.py
```

Contents of `pyproject.toml`:
```
[build-system]
requires = ["setuptools"]
build-backend = "setuptools.build_meta"
```

Contents of `setup.cfg`:
```
[metadata]
name = pkg_test

[options]
packages = find_namespaces:
package_dir =
    =src

[options.packages.find]
where = src
```

```
$ pip install .
&gt; ...
&gt; error: package directory 'src/find_namespaces:' does not exist
&gt; ...
```</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
I believe the correct `setup.cfg` packaging option is `find_namespace:`, not `find_namespaces:`
I can't find any other references to `find_namespaces` in the docs or repository.

Using `find_namespaces:` causes packaging to fail. Example to reproduce:
```
.
├── pyproject.toml
├── setup.cfg
└── src
    ├── pkg1
    │   └── namespace
    │       └── __init__.py
    └── pkg2
        └── __init__.py
```

Contents of `pyproject.toml`:
```
[build-system]
requires = ["setuptools"]
build-backend = "setuptools.build_meta"
```

Contents of `setup.cfg`:
```
[metadata]
name = pkg_test

[options]
packages = find_namespaces:
package_dir =
    =src

[options.packages.find]
where = src
```

```
$ pip install .
&gt; ...
&gt; error: package directory 'src/find_namespaces:' does not exist
&gt; ...
```</pre>
</div>
</content>
</entry>
<entry>
<title>Reorder words in footnote to improve the meaning</title>
<updated>2022-06-17T08:38:05+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri+github@gmail.com</email>
</author>
<published>2022-06-17T08:38:05+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=e85063a9cfcb3de9322fe601f418768f927b73e8'/>
<id>e85063a9cfcb3de9322fe601f418768f927b73e8</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>docs: Reorder example tabs</title>
<updated>2022-06-16T20:59:01+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri@gmail.com</email>
</author>
<published>2022-06-16T20:59:01+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=9d487039eaab63eda2283c69653ef1b09ccf702d'/>
<id>9d487039eaab63eda2283c69653ef1b09ccf702d</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Change wording from *experimental* to *beta*</title>
<updated>2022-06-16T20:50:25+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri@gmail.com</email>
</author>
<published>2022-06-16T20:50:25+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=9c7163bc6030e546ba1133de823d0b4ac06a02d9'/>
<id>9c7163bc6030e546ba1133de823d0b4ac06a02d9</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Clarify warnings and notes in documentation about experimental pyproject.toml</title>
<updated>2022-06-16T20:37:17+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri@gmail.com</email>
</author>
<published>2022-06-07T21:16:34+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=2734a357dad91dcddf3a8e4e5779c5e68da621eb'/>
<id>2734a357dad91dcddf3a8e4e5779c5e68da621eb</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Add more reference links</title>
<updated>2022-06-16T14:00:01+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri@gmail.com</email>
</author>
<published>2022-06-16T14:00:01+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=8e9d323aca308f41bc9f2f8085be31956d0d1aae'/>
<id>8e9d323aca308f41bc9f2f8085be31956d0d1aae</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Add note about possible improvement</title>
<updated>2022-06-16T13:38:47+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri@gmail.com</email>
</author>
<published>2022-06-16T13:38:47+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=d738686eaa23c94e64e772331433692edbac75e9'/>
<id>d738686eaa23c94e64e772331433692edbac75e9</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Update quickstart to make it more streamline</title>
<updated>2022-06-15T17:51:23+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri@gmail.com</email>
</author>
<published>2022-06-15T17:51:23+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=6bd10b2cc1981174275c9e6a12e6808454d82a77'/>
<id>6bd10b2cc1981174275c9e6a12e6808454d82a77</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>
</feed>
