Apply comments per review via IDE to make clearer why certain actions are taken

Author: ArBridgeman

doc/user_guide/getting_started.rst

@@ -39,6 +39,12 @@ Use the following command to create a new project:
    cookiecutter https://github.com/exasol/python-toolbox.git \
     --checkout <latest-tag> --directory project-template
 
+.. note::
+
+    Without option :code:`--checkout` cookiecutter will use the main branch of the PTB. In order
+    to get reliable and reproducible results, we recommend using the tag of PTB's latest released
+    version instead.
+
 **2. Follow the interactive project setup prompt**
 
 **3. Bootstrap the development environment**

test/integration/project-template/conftest.py

@@ -29,6 +29,10 @@ def new_project(cwd):
 @pytest.fixture(scope="session", autouse=True)
 def poetry_install(run_command, poetry_path):
     run_command([poetry_path, "install"])
+    # The tests want to verify the current branch of the PTB incl. its cookiecutter
+    # template before releasing the PTB. The following command therefore modifies the
+    # dependency to the PTB itself in the pyproject.toml file by replacing the latest
+    # released PTB version with the current checked-out branch in PROJECT_CONFIG.root:
     run_command([poetry_path, "add", "--group", "dev", PROJECT_CONFIG.root])