Update include for installing Python, to avoid repetition.

Update after walk-through of process, adding missing bits and pieces.

Author: stevepiercy

docs/_inc/_install-python-plone61.md

@@ -2,7 +2,3 @@ Installing Python is beyond the scope of this documentation.
 However, it is recommended to use a Python version manager, {term}`pyenv`, that allows you to install multiple versions of Python on your development environment without destroying your system's Python.
 % TODO: uncomment this line after upgrading to plone-sphinx-theme and latest Sphinx which supports replacements inside includes.
 % Plone requires Python version {SUPPORTED_PYTHON_VERSIONS_PLONE61}.
-
-Plone 6.0 requires Python version 3.8, 3.9, 3.10, 3.11, or 3.12.
-
-Plone 6.1 requires Python version 3.10, 3.11, or 3.12.

docs/admin-guide/install-buildout.md

@@ -14,7 +14,7 @@ myst:
 This chapter describes how you can install Plone using {term}`Buildout`.
 
 This is one way to install Plone with the Classic UI.
-Using Buildout will be the most familiar approach for admins who have experience with Plone 3, 4, or 5.
+Using Buildout will be the most familiar approach for administrators who have experience with Plone 3, 4, or 5.
 
 ```{seealso}
 For other installation options, see {ref}`get-started-install-label`.
@@ -26,39 +26,40 @@ For other installation options, see {ref}`get-started-install-label`.
 
 - For Plone 6.0, Python {SUPPORTED_PYTHON_VERSIONS_PLONE60}
 - For Plone 6.1, Python {SUPPORTED_PYTHON_VERSIONS_PLONE61}
-- Buildout
 
 
 ### Python
 
 ```{include} /_inc/_install-python-plone61.md
 ```
 
-### Buildout
-
-See [Getting started with Buildout](http://www.buildout.org/en/latest/getting-started.html).
-
 
 ## Installation
 
-Select a directory of your choice:
+Select a directory of your choice.
 
 ```shell
-mkdir -p /opt/plone && cd /opt/plone
+mkdir -p <my_projects>/plone && cd <my_projects>/plone
 ```
 
-Create a Python virtual environment:
+Create a Python virtual environment.
 
 ```shell
 python3 -m venv .
 ```
 
-Install the minimal Python packages needed in order to run Buildout:
+Install the minimal Python packages needed in order to run Buildout.
 
 ```shell
 bin/pip install -r https://dist.plone.org/release/6-latest/requirements.txt
 ```
 
+Install Buildout into the Python virtual environment.
+
+```shell
+bin/pip install zc.buildout
+```
+
 Create a `buildout.cfg` file in your directory with the following contents:
 
 ```cfg
@@ -77,12 +78,15 @@ eggs =
     Plone
 ```
 
-Run buildout:
+Run Buildout.
 
 ```shell
 bin/buildout
 ```
 
+This may take a few minutes.
+
+
 ## Run Plone in foreground mode
 
 Start the instance for a quick test in foreground mode:
@@ -91,21 +95,33 @@ Start the instance for a quick test in foreground mode:
 bin/instance fg
 ```
 
-Your instance starts in foreground mode, which is only advisable for troubleshooting or for local demonstration purposes.
+Your instance starts in foreground mode.
+This should be used only for troubleshooting or local demonstration purposes.
+
+Now you can visit `http://localhost:8080` in your browser.
+Select {guilabel}`Create Classic UI Plone site`.
+
+Enter {guilabel}`username` of `admin`, and {guilabel}`password` of `admin`.
+
+Fill out the form as needed, and click {guilabel}`Create Plone Site`.
+
+You will be redirected to your new Plone instance.
+
+To stop the Plone instance in foreground mode, type {kbd}`CTRL-C`.
 
-Now you can call the url `http://localhost:8080` in your browser and you can add a **Classic UI Plone site**.
 
 ## Start Plone as a background service
 
-Start the instance:
+Start the instance.
 
 ```shell
 bin/instance start
 ```
 
+
 ## Stop Plone as a background service
 
-Stop the instance:
+Stop the instance.
 
 ```shell
 bin/instance stop