Tidy up override-core.md

Author: stevepiercy

docs/admin-guide/override-core.md

@@ -4,24 +4,25 @@ myst:
     "description": "Override core Plone packages"
     "property=og:description": "Override core Plone packages"
     "property=og:title": "Override core Plone packages"
-    "keywords": "Plone 6, core, package, version, override"
+    "keywords": "Plone 6, core, package, version, override, Cookieplone, cookiecutter-plone-starter, Buildout"
 ---
 
 (override-core-plone-packages-label)=
 
 # Override core Plone packages
 
-Plone includes a lot of Python packages.
-Sometimes it is necessary to override one or more package versions in order to fix a bug.
+Plone includes a few hundred Python packages.
+Sometimes you will need to override one or more package versions to fix a bug.
 
 
-## with Cookieplone
+## Cookieplone
 
 Use the following instructions if you installed Plone with Cookieplone or `cookiecutter-plone-starter`.
 
+
 ### Override a core Plone package
 
-Add a version override to {file}`mx.ini`.
+Add a version override to the file {file}`mx.ini`.
 This example uses `plone.api`.
 
 ```
@@ -37,24 +38,28 @@ For an explanation of why Plone uses `mxdev`, see {ref}`manage-backend-python-pa
 
 Stop the backend with {kbd}`ctrl-c`.
 
-To actually download and install the new package version, run:
+To actually download and install the new package version, run the following command.
 
 ```shell
 make backend-build
 ```
 
 ```{note}
-If you installed Plone using `cookiecutter-plone-starter`, run `make build-backend` instead.`
+If you installed Plone using `cookiecutter-plone-starter`, run `make build-backend` instead.
 ```
 
 Now restart the backend.
 
+```{seealso}
+{doc}`run-plone`
+```
+
 
 ### Install a core Plone package from source
 
-`mxdev` can also be used to install core Plone packages from a source control system such as GitHub.
+You can also use `mxdev` to install core Plone packages from a source control system such as GitHub.
 
-Add the Plone package you want to check out in {file}`mx.ini`.
+Add the Plone package you want to check out in the file {file}`mx.ini`.
 This example uses `plone.restapi`.
 
 ```cfg
@@ -66,7 +71,7 @@ extras = test
 
 Stop the backend with {kbd}`ctrl-c`.
 
-To actually download and install the new package version, run:
+To actually download and install the new package version, run the following command.
 
 ```shell
 make backend-build
@@ -78,14 +83,18 @@ If you installed Plone using `cookiecutter-plone-starter`, run `make build-backe
 
 Now restart the backend.
 
+```{seealso}
+{doc}`run-plone`
+```
+
 
-## with Buildout
+## Buildout
 
 Use the following instructions if you installed Plone with Buildout.
 
 ### Override a core Plone package
 
-Update {file}`buildout.cfg`.
+Update the file {file}`buildout.cfg`.
 This example uses `plone.api`.
 
 ```cfg
@@ -111,20 +120,24 @@ plone.api = 2.0.0a3
 The version pins specified in the `[versions]` section will take precedence over the pins inherited from `https://dist.plone.org/release/6-latest/versions.cfg`.
 ```
 
-To actually download and install the new package version, run:
+To actually download and install the new package version, run the following command.
 
 ```shell
 bin/buildout
 ```
 
 Then restart your instance.
 
+```{seealso}
+{doc}`run-plone`
+```
+
 
 ### Install a core Plone package from source
 
 A core Plone package can be installed from a source control system such as GitHub.
 
-Update {file}`buildout.cfg`.
+Update the file {file}`buildout.cfg`.
 This example uses `plone.restapi`.
 
 ```cfg
@@ -156,12 +169,18 @@ plone.restapi =
 Setting an empty version ensures that the copy of `plone.restapi` from source control will be used, instead of the version pin inherited from https://dist.plone.org/release/6-latest/versions.cfg.
 ```
 
-To actually download and install the new add-on, run:
+To actually download and install the new add-on, run the following command.
 
 ```shell
 bin/buildout
 ```
 
+Then restart your instance.
+
+```{seealso}
+{doc}`run-plone`
+```
+
 ```{seealso}
 This approach uses the [`mr.developer`](https://pypi.org/project/mr.developer/) Buildout extension.
 ```