summaryrefslogtreecommitdiff
path: root/docs/userguide/quickstart.rst
Commit message (Collapse)AuthorAgeFilesLines
* Reorder words in footnote to improve the meaningAnderson Bravalheri2022-06-171-1/+1
|
* docs: Reorder example tabsAnderson Bravalheri2022-06-161-58/+59
|
* Change wording from *experimental* to *beta*Anderson Bravalheri2022-06-161-7/+7
|
* Clarify warnings and notes in documentation about experimental pyproject.tomlAnderson Bravalheri2022-06-161-8/+6
|
* Add more reference linksAnderson Bravalheri2022-06-161-3/+5
|
* Add note about possible improvementAnderson Bravalheri2022-06-161-0/+11
|
* Update quickstart to make it more streamlineAnderson Bravalheri2022-06-151-54/+86
|
* Improve docs by avoiding confusion with distutilsAnderson Bravalheri2022-06-121-8/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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`
* Missing the word "pyproject.toml" in Quickstart.Michael Loyd2022-05-241-1/+1
| | | In the sentence "If you are experimenting with configuration using, or have version of..."
* Warn about deprecation of behaviour that considers modules/packages as data ↵Anderson Bravalheri2022-05-161-1/+1
|\ | | | | | | when include_package_data=True (#3308)
| * Quickfix missing comment mark in docsAnderson Bravalheri2022-05-051-1/+1
| |
* | Clarify that `pyproject.toml` config will not be removedJim Garrison2022-04-291-1/+1
|/ | | | | | | | | | | | | | | | | The current documentation regarding `pyproject.toml` claims that support for using it to specify package metadata and build configuration options might be "completely removed" in a future release. However, nowadays it is clear (https://github.com/pypa/setuptools/issues/1688#issuecomment-1079706929 and #3214) that `pyproject.toml` is not going anywhere, is here to stay, and is in fact expected to be the preferred format in the future. This makes an incremental change toward that future by clarifying that `pyproject.toml` support will not be removed in a future release of setuptools.
* Fix typo in docsVladimir Berlev2022-04-141-1/+1
|
* Fix typo in quickstart sectionPablo Cárdenas2022-03-261-1/+1
| | | | | The function should be between quotes like a string. cli-name = mypkg.mymodule:some_func => cli-name = "mypkg.mymodule:some_func"
* Fix `bellow` typo in docsMathieu Kniewallner2022-03-241-1/+1
|
* Add back notes about editable install and pyproject metadataAnderson Bravalheri2022-03-241-1/+17
| | | | On further examination, `pip` seems to fail if `setup.py` is missing.
* Fix wrong version reference in quickstartAnderson Bravalheri2022-03-241-1/+1
|
* Improve note about setup.pyAnderson Bravalheri2022-03-241-1/+2
|
* Add missing prepositionAnderson Bravalheri2022-03-241-1/+1
|
* Add module to entry_point example in quickstartAnderson Bravalheri2022-03-241-4/+4
|
* Improve text about CLI entry-point in quickstartAnderson Bravalheri2022-03-241-2/+3
|
* Fix example of environment maker for dependencies in quickstartAnderson Bravalheri2022-03-241-1/+1
|
* Restore tip about editable installsAnderson Bravalheri2022-03-241-20/+3
| | | | | Experiments with pip 21.1 confirm that it can use editable mode even when `setup.py` is missing.
* Small doc improvementsAnderson Bravalheri2022-03-171-1/+1
|
* Apply suggestions from code reviewAnderson Bravalheri2022-03-171-3/+3
| | | Co-authored-by: Steven Silvester <steven.silvester@ieee.org>
* Clarify extras in entry-points are deprecatedAnderson Bravalheri2022-03-171-1/+1
|
* Improve notes on quickstartAnderson Bravalheri2022-03-171-37/+47
|
* Clarify editable installs note in quickstartAnderson Bravalheri2022-03-171-21/+22
|
* Add note about editable installs in quickstartAnderson Bravalheri2022-03-171-1/+17
|
* Improve data files section in quickstartAnderson Bravalheri2022-03-171-3/+27
|
* Improve dependencies section in quickstartAnderson Bravalheri2022-03-171-16/+41
|
* Improve entry-points section in the quickstartAnderson Bravalheri2022-03-171-11/+37
|
* Improve discovery section in the quickstartAnderson Bravalheri2022-03-171-10/+55
|
* Fix link to keywordsAnderson Bravalheri2022-03-171-1/+1
|
* Add some missing references in the quickstartAnderson Bravalheri2022-03-171-5/+5
|
* Mention experimental pyproject config in the quickstartAnderson Bravalheri2022-03-171-7/+37
|
* Add missing link to PyPUG MANIFEST.in docsAnderson Bravalheri2022-03-031-1/+1
|
* Add link to MANIFEST.in in quickstartAnderson Bravalheri2022-03-031-1/+7
|
* Stop mentioning `wheel` in the context of PEP 517Sviatoslav Sydorenko2022-01-271-1/+1
| | | | | | This dependency is exposed automatically by setuptools and the users do not need to declare it explicitly — it will be installed by PEP 517 front-ends automatically, when building wheels.
* doc: Fix trailing spaces, tabs, and missing newlines at end of file.Julien Palard2022-01-241-4/+4
|
* Update docs/userguide/quickstart.rstAnanth Pattabiraman2022-01-071-1/+1
| | | Co-authored-by: Anderson Bravalheri <andersonbravalheri+github@gmail.com>
* add resources on packagingAnanth Pattabiraman2022-01-071-2/+3
| | | Section `Resources on Python packaging` did not point to any resource. Added as discussed on #2674
* Update quickstart.rsteacheson2021-12-241-13/+13
| | | fix various english issues
* fix: typo 'extras_require'Rodrigo Mologni2021-12-041-1/+1
|
* Improve the mention of pip version that doesn't need `setup.py`Sviatoslav Sydorenko2021-11-121-2/+3
| | | Co-authored-by: Jason R. Coombs <jaraco@jaraco.com>
* Document that pip works with editable setup.cfgSviatoslav Sydorenko2021-11-111-9/+9
|
* docs(quickstart): add link to "Development Mode"Mozi2021-09-121-1/+1
|
* Merge branch 'main' into change-docs-themeJason R. Coombs2021-07-181-22/+42
|\
| * Merge pull request #2668 from carltongibson/c/fix-example-indentJason R. Coombs2021-05-191-2/+2
| |\ | | | | | | Corrected tabs for spaces in quickstart example.
| | * Corrected tabs for spaces in quickstart example.Carlton Gibson2021-05-101-2/+2
| | |
View Lorry Controller Status