Remove Quickstart from README

The README on the GitHub repository page reflects the state of the master
branch, instead of the stable release. To reduce potential confusion, it's
better to keep the README short, and omit the Quickstart content. This content
is still available on Read the Docs, and now lives in quickstart.rst itself,
instead of being included from the README.

The README now consists of the badges, the logo, the usage, and the list of
features. Sphinx references are spread out over the README, the Quickstart
Guide, and the User Guide, with each of these including references from its
predecessors.

Author: cjolowicz

README.rst

@@ -91,202 +91,6 @@ The template supports Python 3.6, 3.7, 3.8, and 3.9.
 
 .. features-end
 
-
-Quickstart
-==========
-
-.. quickstart-begin
-
-Requirements
-------------
-
-Install Cookiecutter_:
-
-.. code:: console
-
-   $ pipx install cookiecutter
-
-Install Poetry_ by downloading and running get-poetry.py_:
-
-.. _get-poetry.py: https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py
-
-.. code:: console
-
-   $ python get-poetry.py
-
-Install Nox_ and nox-poetry_:
-
-.. code:: console
-
-   $ pipx install nox
-   $ pipx inject nox nox-poetry
-
-pipx_ is preferred, but you can also install with ``pip install --user``.
-
-It is recommended to set up Python 3.6, 3.7, 3.8, and 3.9 using pyenv_.
-
-
-Creating a project
-------------------
-
-Generate a Python project:
-
-.. code:: console
-
-   $ cookiecutter gh:cjolowicz/cookiecutter-hypermodern-python \
-     --checkout="2020.11.15"
-
-Change to the root directory of your new project,
-and create a Git repository:
-
-.. code:: console
-
-   $ git init
-   $ git add .
-   $ git commit
-
-
-Running
--------
-
-Run the command-line interface from the source tree:
-
-.. code:: console
-
-   $ poetry install
-   $ poetry run <project>
-
-Run an interactive Python session:
-
-.. code:: console
-
-   $ poetry install
-   $ poetry run python
-
-
-Testing
--------
-
-Run the full test suite:
-
-.. code:: console
-
-   $ nox
-
-List the available Nox sessions:
-
-.. code:: console
-
-   $ nox --list-sessions
-
-Install the pre-commit hooks:
-
-.. code:: console
-
-   $ nox -s pre-commit -- install
-
-
-Continuous Integration
-----------------------
-
-GitHub
-~~~~~~
-
-1. Sign up at GitHub_.
-2. Create an empty repository for your project.
-3. Follow the instructions to push an existing repository from the command line.
-
-
-PyPI
-~~~~
-
-1. Sign up at PyPI_.
-2. Go to the Account Settings on PyPI,
-   generate an API token, and copy it.
-3. Go to the repository settings on GitHub, and
-   add a secret named ``PYPI_TOKEN`` with the token you just copied.
-
-
-TestPyPI
-~~~~~~~~
-
-1. Sign up at TestPyPI_.
-2. Go to the Account Settings on TestPyPI,
-   generate an API token, and copy it.
-3. Go to the repository settings on GitHub, and
-   add a secret named ``TEST_PYPI_TOKEN`` with the token you just copied.
-
-
-Codecov
-~~~~~~~
-
-1. Sign up at Codecov_.
-2. Install their GitHub app.
-
-
-Read the Docs
-~~~~~~~~~~~~~
-
-1. Sign up at `Read the Docs`_.
-2. Import your GitHub repository, using the button *Import a Project*.
-3. Install the GitHub webhook,
-   using the button *Add integration*
-   on the *Integrations* tab
-   in the *Admin* section of your project
-   on Read the Docs.
-
-
-Releasing
----------
-
-Releases are triggered by a version bump on the default branch.
-It is recommended to do this in a separate pull request:
-
-1. Switch to a branch.
-2. Bump the version using `poetry version`_.
-3. Commit and push to GitHub.
-4. Open a pull request.
-5. Merge the pull request.
-
-.. _poetry version: https://python-poetry.org/docs/cli/#version
-
-The Release workflow performs the following automated steps:
-
-- Build and upload the package to PyPI.
-- Apply a version tag to the repository.
-- Publish a GitHub Release.
-
-Release notes are populated with the titles and authors of merged pull requests.
-You can group the pull requests into separate sections
-by applying labels to them, like this:
-
-.. table-release-drafter-sections-begin
-
-.. table::
-   :class: hypermodern-table
-   :widths: auto
-
-   =================== ============================
-   Pull Request Label  Section in Release Notes
-   =================== ============================
-   ``breaking``        💥 Breaking Changes
-   ``enhancement``     🚀 Features
-   ``removal``         🔥 Removals and Deprecations
-   ``bug``             🐞 Fixes
-   ``performance``     🐎 Performance
-   ``testing``         🚨 Testing
-   ``ci``              👷 Continuous Integration
-   ``documentation``   📚 Documentation
-   ``refactoring``     🔨 Refactoring
-   ``style``           💄 Style
-   ``dependencies``    📦 Dependencies
-   =================== ============================
-
-
-.. table-release-drafter-sections-end
-
-.. quickstart-end
-
 .. references-begin
 
 .. _Bandit: https://github.com/PyCQA/bandit
@@ -297,7 +101,6 @@ by applying labels to them, like this:
 .. _Coverage.py: https://coverage.readthedocs.io/
 .. _Dependabot: https://dependabot.com/
 .. _Flake8: http://flake8.pycqa.org
-.. _GitHub: https://github.com/
 .. _GitHub Actions: https://github.com/features/actions
 .. _Hypermodern Python: https://medium.com/@cjolowicz/hypermodern-python-d44485d9d769
 .. _Nox: https://nox.thea.codes/
@@ -313,10 +116,7 @@ by applying labels to them, like this:
 .. _autodoc: https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html
 .. _mypy: http://mypy-lang.org/
 .. _napoleon: https://www.sphinx-doc.org/en/master/usage/extensions/napoleon.html
-.. _nox-poetry: https://nox-poetry.readthedocs.io/
-.. _pipx: https://pipxproject.github.io/pipx/
 .. _pre-commit: https://pre-commit.com/
-.. _pyenv: https://github.com/pyenv/pyenv
 .. _pytest: https://docs.pytest.org/en/latest/
 .. _sphinx-click: https://sphinx-click.readthedocs.io/
 .. _xdoctest: https://github.com/Erotemic/xdoctest

docs/guide.rst

@@ -2372,7 +2372,7 @@ Release notes are populated with the titles and authors of merged pull requests.
 You can group the pull requests into separate sections
 by applying labels to them, like this:
 
-.. include:: ../README.rst
+.. include:: quickstart.rst
    :start-after: table-release-drafter-sections-begin
    :end-before: table-release-drafter-sections-end
 
@@ -2617,6 +2617,10 @@ __ https://cjolowicz.github.io/posts/hypermodern-python-01-setup/
    :start-after: references-begin
    :end-before: references-end
 
+.. include:: ./quickstart.rst
+   :start-after: quickstart-references-begin
+   :end-before: quickstart-references-end
+
 .. _Calendar Versioning: https://calver.org
 .. _GitHub Release: https://help.github.com/en/github/administering-a-repository/about-releases
 .. _Hypermodern Python Cookiecutter: https://github.com/cjolowicz/cookiecutter-hypermodern-python