Merge pull request #1980 from bjones1/poetry-fix

Clean: Remove unused poetry-fix script, clean up docs.

Author: bnmnetp

pyproject.toml

@@ -2,9 +2,15 @@
 # |docname| - Poetry configuration
 # ********************************
 # See the `Poetry docs <https://python-poetry.org/docs/dependency-specification/>`_ to get an understanding of
-# how poetry does specifies dependencies.
+# how poetry specifies dependencies.
 #
-# **Important**: Before running ``poetry install`` or ``poetry update``, run ``poetry-fix`` so that development dependencies will be installed correctly. See `runestone_poetry_project/poetry_fix.py`. Since this script isn't installed until the first run of ``poetry install``, run the script after the install then run ``poetry update`` again.
+# **Important**: This program performs automated edits to the ``pyproject.toml`` files for this project and all its subprojects (such as the BookServer and the Runestone Components) specified by `path dependencies <https://python-poetry.org/docs/dependency-specification/#path-dependencies>`_. Therefore, you **must** run ``python runestone/poetry_fix.py`` after making any changes to this file or any ``pyproject.toml`` `path dependencies`_ to keep these files up to date.
+#
+# .. toctree::
+#   :maxdepth: 2
+#
+#   runestone_poetry_project/__init__.py
+#   runestone_poetry_project/poetry_fix.py
 #
 #
 # Project metadata
@@ -79,19 +85,6 @@ runestone-dev = { path = "../runestone-dev", develop = true }
 selenium = "^3.0.0"
 
 
-# Scripts
-# =======
-# See `scripts <https://python-poetry.org/docs/pyproject/#scripts>`_. This refers to the following files:
-#
-# .. toctree::
-#
-#   runestone_poetry_project/__init__.py
-#   runestone_poetry_project/poetry_fix.py
-#
-[tool.poetry.scripts]
-poetry-fix = "runestone_poetry_project.poetry_fix:main"
-
-
 # Poetry backend
 # ==============
 [build-system]