<feed xmlns='http://www.w3.org/2005/Atom'>
<title>delta/python-setuptools-git.git/docs/index.rst, branch dev/core_metadata</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>Apply suggestions from code review</title>
<updated>2022-06-13T08:43:16+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri+github@gmail.com</email>
</author>
<published>2022-06-13T08:43:16+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=3ed077fa5a82bec81693876b4a0414b9d16d5d91'/>
<id>3ed077fa5a82bec81693876b4a0414b9d16d5d91</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>Rename `docs/{images/README =&gt; artwork}.rst`</title>
<updated>2022-01-06T16:10:39+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri@gmail.com</email>
</author>
<published>2022-01-06T16:05:57+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=5c7a84c63ae1d7f93d8cc0008311d47906a24117'/>
<id>5c7a84c63ae1d7f93d8cc0008311d47906a24117</id>
<content type='text'>
Unfortunately sphinx do not accept `.rst` files inside folders that are
added to the `html_static_path`.

(Adding `docs/images` to `html_static_path` will be required in a follow
up commit to adopt the `sphinx-favicon` extension)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Unfortunately sphinx do not accept `.rst` files inside folders that are
added to the `html_static_path`.

(Adding `docs/images` to `html_static_path` will be required in a follow
up commit to adopt the `sphinx-favicon` extension)
</pre>
</div>
</content>
</entry>
<entry>
<title>Add docs/README to the toctree</title>
<updated>2021-11-04T13:19:52+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri@gmail.com</email>
</author>
<published>2021-11-04T03:22:27+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=300093105848dfbf2a95f490a92e91620d8199c0'/>
<id>300093105848dfbf2a95f490a92e91620d8199c0</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Rename logo files</title>
<updated>2021-11-04T13:19:51+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri@gmail.com</email>
</author>
<published>2021-11-04T02:39:55+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=b7c2e2b49ca2db77051410bed87f034306222b42'/>
<id>b7c2e2b49ca2db77051410bed87f034306222b42</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Add banner to main docs page</title>
<updated>2021-11-04T13:19:51+00:00</updated>
<author>
<name>Anderson Bravalheri</name>
<email>andersonbravalheri@gmail.com</email>
</author>
<published>2021-11-04T02:27:53+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=9fd5fb36e9dd634a08b29be759d6e4959b703adc'/>
<id>9fd5fb36e9dd634a08b29be759d6e4959b703adc</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Merge branch 'main' into change-docs-theme</title>
<updated>2021-07-18T19:13:50+00:00</updated>
<author>
<name>Jason R. Coombs</name>
<email>jaraco@jaraco.com</email>
</author>
<published>2021-07-18T19:13:50+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=01f2abe71dc72fdf5b345f4ac3086a94b23efd15'/>
<id>01f2abe71dc72fdf5b345f4ac3086a94b23efd15</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Merge https://github.com/jaraco/tidelift</title>
<updated>2021-07-18T19:02:56+00:00</updated>
<author>
<name>Jason R. Coombs</name>
<email>jaraco@jaraco.com</email>
</author>
<published>2021-07-18T19:02:56+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=aa5ef507f3bf78092abfff7c6a2cf55a9b2fb2dc'/>
<id>aa5ef507f3bf78092abfff7c6a2cf55a9b2fb2dc</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Implement tidelift banner using a Sphinx directive implemented by jaraco.tidelift.</title>
<updated>2021-07-18T18:48:16+00:00</updated>
<author>
<name>Jason R. Coombs</name>
<email>jaraco@jaraco.com</email>
</author>
<published>2021-07-18T18:48:16+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=918a415b41225f442d6e9b319ecebff19b52a1a5'/>
<id>918a415b41225f442d6e9b319ecebff19b52a1a5</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Tweak the index page's contents</title>
<updated>2020-12-28T17:54:23+00:00</updated>
<author>
<name>Pradyun Gedam</name>
<email>pradyunsg@users.noreply.github.com</email>
</author>
<published>2020-12-28T17:54:23+00:00</published>
<link rel='alternate' type='text/html' href='http://91.123.203.49/cgit/delta/python-setuptools-git.git/commit/?id=5c24e780b83e4557ca6e9e48b468e6f4a82695c9'/>
<id>5c24e780b83e4557ca6e9e48b468e6f4a82695c9</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
</feed>
