Clean up Install / Containers chapter

Author: stevepiercy

docs/glossary.md

@@ -285,16 +285,16 @@ DPI
     ```{seealso}
     https://developer.mozilla.org/en-US/docs/Web/CSS/resolution#dpi
     ```
-```
 
 Docker
-    [Docker](https://docker.com) is an open platform for developing, shipping, and running applications using containers.
+    [Docker](https://www.docker.com/) is an open platform for developing, shipping, and running applications using containers.
 
 RelStorage
-    [RelStorage](https://relstorage.readthedocs.io) is a storage implementation for ZODB that stores pickles in a relational database.
+    [RelStorage](https://relstorage.readthedocs.io/en/latest/) is a storage implementation for ZODB that stores pickles in a relational database.
 
 ZEO
-    [ZEO](https://zeo.readthedocs.io) is a client-server storage for ZODB for sharing a single storage among many clients.
+    [ZEO](https://zeo.readthedocs.io/en/latest/) is a client-server storage for ZODB for sharing a single storage among many clients.
 
 PostgreSQL
     [PostgreSQL](https://www.postgresql.org/) is a powerful, open source object-relational database.
+```

docs/install/containers/examples/index.md

@@ -2,10 +2,11 @@
 html_meta:
   "description": "Examples of Plone 6 setup with containers"
   "property=og:description": "Examples of Plone 6 setup with containers"
-  "property=og:title": "Example usage of Plone 6 with containers"
+  "property=og:title": "Examples of Plone 6 using containers"
   "keywords": "Plone 6, install, installation, docker, containers"
 ---
-# Examples
+
+# Examples of Plone 6 using containers
 
 ```{toctree}
 :maxdepth: 2
@@ -17,11 +18,11 @@ nginx-volto-plone-postgresql
 nginx-plone
 ```
 
-Examples of projects running Plone using `docker-compose`
+Examples of projects running Plone using `docker-compose`.
 
-| Project example                                              | Description                                             |
-| ------------------------------------------------------------ | ------------------------------------------------------- |
-| [nginx-volto-plone](nginx-volto-plone)                       | Stack with nginx, Frontend and Backend                  |
-| [nginx-volto-plone-zeo](nginx-volto-plone-zeo)               | Stack with nginx, Frontend, Backend and ZEO server      |
-| [nginx-volto-plone-postgresql](nginx-volto-plone-postgresql) | Stack with nginx, Frontend, Backend and PostgreSQL DB   |
-| [nginx-plone](nginx-plone)                                   | Stack with nginx, and Backend (Plone Classic)           |
+| Project example | Description |
+| --- | --- |
+| [nginx-volto-plone](nginx-volto-plone) | Stack with nginx, Frontend and Backend |
+| [nginx-volto-plone-zeo](nginx-volto-plone-zeo) | Stack with nginx, Frontend, Backend and ZEO server |
+| [nginx-volto-plone-postgresql](nginx-volto-plone-postgresql) | Stack with nginx, Frontend, Backend and PostgreSQL DB |
+| [nginx-plone](nginx-plone) | Stack with nginx, and Backend (Plone Classic) |

docs/install/containers/examples/nginx-plone.md

@@ -1,10 +1,19 @@
-# Nginx, Plone Classic
+---
+html_meta:
+  "description": "Simple Plone 6 setup with one backend and data being persisted in a Docker volume."
+  "property=og:description": "Simple Plone 6 setup with one backend and data being persisted in a Docker volume."
+  "property=og:title": "Nginx, Plone Classic container example"
+  "keywords": "Plone 6, Container, Docker, Nginx, Plone Classic"
+---
+
+# Nginx, Plone Classic container example
 
 Simple setup with one backend and data being persisted in a Docker volume.
 
+
 ## Setup
 
-Create an empty project directory named `nginx-plone`
+Create an empty project directory named `nginx-plone`.
 
 ```shell
 mkdir nginx-plone
@@ -16,6 +25,7 @@ Change into your project directory.
 cd nginx-plone
 ```
 
+
 ### nginx configuration
 
 Add a `default.conf` that will be used by the nginx image:
@@ -40,9 +50,10 @@ server {
 }
 ```
 
-### Service configuration with docker-compose
 
-Now, let's create a `docker-compose.yml` file:
+### Service configuration with `docker-compose`
+
+Now let's create a `docker-compose.yml` file:
 
 ```yaml
 version: "3"
@@ -71,22 +82,25 @@ volumes:
   data: {}
 ```
 
+
 ## Build the project
 
-Start the stack with `docker-compose` (or `docker compose` for newer versions)
+Start the stack with `docker-compose`.
 
 ```shell
 docker-compose up -d
 ```
 
-This will pulls the needed images, and starts Plone.
+This pulls the needed images and starts Plone.
+
 
 ## Access Plone via Browser
 
 After startup, go to `http://plone.localhost/` and you should see the site.
 
+
 ## Shutdown and cleanup
 
-The command docker-compose down removes the containers and default network, but preserves the Plone database.
+The command `docker-compose down` removes the containers and default network, but preserves the Plone database.
 
-The command docker-compose down --volumes removes the containers, default network, and the Plone database.
+The command `docker-compose down --volumes` removes the containers, default network, and the Plone database.

docs/install/containers/examples/nginx-volto-plone-postgresql.md

@@ -1,10 +1,19 @@
-# Nginx, Frontend, Backend, Postgres
+---
+html_meta:
+  "description": "Very simple Plone 6 setup with only one or more backend instances accessing a PostgreSQL server and data being persisted in a Docker volume."
+  "property=og:description": "Very simple Plone 6 setup with only one or more backend instances accessing a PostgreSQL server and data being persisted in a Docker volume."
+  "property=og:title": "Nginx, Frontend, Backend, PostgreSQL container example"
+  "keywords": "Plone 6, Container, Docker, Nginx, Frontend, Backend, PostgreSQL, "
+---
+
+# Nginx, Frontend, Backend, PostgreSQL container example
 
 Very simple setup with only one or more backend instances accessing a Postgres server and data being persisted in a Docker volume.
 
+
 ## Setup
 
-Create an empty project directory named `nginx-volto-plone-postgresql`
+Create an empty project directory named `nginx-volto-plone-postgresql`.
 
 ```shell
 mkdir nginx-volto-plone-postgresql
@@ -16,6 +25,7 @@ Change into your project directory.
 cd nginx-volto-plone-postgresql
 ```
 
+
 ### nginx configuration
 
 Add a `default.conf` that will be used by the nginx image:
@@ -65,9 +75,10 @@ server {
 }
 ```
 
-### Service configuration with docker-compose
 
-Now, let's create a `docker-compose.yml` file:
+### Service configuration with `docker-compose`
+
+Now let's create a `docker-compose.yml` file:
 
 ```yaml
 version: "3"
@@ -117,30 +128,34 @@ volumes:
   data: {}
 ```
 
+
 ## Build the project
 
-Start the stack with `docker-compose` (or `docker compose` for newer versions)
+Start the stack with `docker-compose`.
 
 ```shell
 docker-compose up -d
 ```
 
-This will pulls the needed images, and starts Plone.
+This pulls the needed images and starts Plone.
+
 
 ## Access Plone via Browser
 
 After startup, go to `http://plone.localhost/` and you should see the site.
 
+
 ## Increase the number of backends
 
-To use two containers for backend, run `docker-compose` with `--scale`
+To use two containers for backend, run `docker-compose` with `--scale`.
 
 ```shell
 docker-compose up --scale backend=2
 ```
 
+
 ## Shutdown and cleanup
 
-The command docker-compose down removes the containers and default network, but preserves the Plone database.
+The command `docker-compose down` removes the containers and default network, but preserves the Plone database.
 
-The command docker-compose down --volumes removes the containers, default network, and the Plone database.
+The command `docker-compose down --volumes` removes the containers, default network, and the Plone database.

docs/install/containers/examples/nginx-volto-plone-zeo.md

@@ -1,10 +1,19 @@
-# Nginx, Frontend, Backend, ZEO
+---
+html_meta:
+  "description": "Very simple Plone 6 setup with only one or more backend instances accessing a ZEO server and data being persisted in a Docker volume."
+  "property=og:description": "Very simple Plone 6 setup with only one or more backend instances accessing a ZEO server and data being persisted in a Docker volume."
+  "property=og:title": "Nginx, Frontend, Backend, ZEO container example"
+  "keywords": "Plone 6, Container, Docker, Nginx, Frontend, Backend, ZEO"
+---
+
+# Nginx, Frontend, Backend, ZEO container example
 
 Very simple setup with only one or more backend instances accessing a ZEO server and data being persisted in a Docker volume.
 
+
 ## Setup
 
-Create an empty project directory named `nginx-volto-plone-zeo`
+Create an empty project directory named `nginx-volto-plone-zeo`.
 
 ```shell
 mkdir nginx-volto-plone-zeo
@@ -16,6 +25,7 @@ Change into your project directory.
 cd nginx-volto-plone-zeo
 ```
 
+
 ### nginx configuration
 
 Add a `default.conf` that will be used by the nginx image:
@@ -65,9 +75,10 @@ server {
 }
 ```
 
-### Service configuration with docker-compose
 
-Now, let's create a `docker-compose.yml` file:
+### Service configuration with `docker-compose`
+
+Now let's create a `docker-compose.yml` file:
 
 ```yaml
 version: "3"
@@ -114,30 +125,34 @@ volumes:
   data: {}
 ```
 
+
 ## Build the project
 
-Start the stack with `docker-compose` (or `docker compose` for newer versions)
+Start the stack with `docker-compose`.
 
 ```shell
 docker-compose up -d
 ```
 
-This will pulls the needed images, and starts Plone.
+This pulls the needed images and starts Plone.
+
 
 ## Access Plone via Browser
 
 After startup, go to `http://plone.localhost/` and you should see the site.
 
+
 ## Increase the number of backends
 
-To use two containers for backend, run `docker-compose` with `--scale`
+To use two containers for the backend, run `docker-compose` with `--scale`.
 
 ```shell
 docker-compose up --scale backend=2
 ```
 
+
 ## Shutdown and cleanup
 
-The command docker-compose down removes the containers and default network, but preserves the Plone database.
+The command `docker-compose down` removes the containers and default network, but preserves the Plone database.
 
-The command docker-compose down --volumes removes the containers, default network, and the Plone database.
+The command `docker-compose down --volumes` removes the containers, default network, and the Plone database.

docs/install/containers/examples/nginx-volto-plone.md

@@ -1,7 +1,16 @@
-# Nginx, Frontend, Backend
+---
+html_meta:
+  "description": "Very simple Plone 6 setup with only one backend and data being persisted in a Docker volume."
+  "property=og:description": "Very simple Plone 6 setup with only one backend and data being persisted in a Docker volume."
+  "property=og:title": "Nginx, Frontend, Backend container example"
+  "keywords": "Plone 6, Container, Docker, Nginx, Frontend, Backend"
+---
+
+# Nginx, Frontend, Backend container example
 
 Very simple setup with only one backend and data being persisted in a Docker volume.
 
+
 ## Setup
 
 Create an empty project directory named `nginx-volto-plone`
@@ -16,6 +25,7 @@ Change into your project directory.
 cd nginx-volto-plone
 ```
 
+
 ### nginx configuration
 
 Add a `default.conf` that will be used by the nginx image:
@@ -65,9 +75,10 @@ server {
 }
 ```
 
-### Service configuration with docker-compose
 
-Now, let's create a `docker-compose.yml` file:
+### Service configuration with `docker-compose`
+
+Now let's create a `docker-compose.yml` file:
 
 ```yaml
 version: "3"
@@ -105,22 +116,25 @@ volumes:
   data: {}
 ```
 
+
 ## Build the project
 
-Start the stack with `docker-compose` (or `docker compose` for newer versions)
+Start the stack with `docker-compose`.
 
 ```shell
 docker-compose up -d
 ```
 
-This will pulls the needed images, and starts Plone.
+This pulls the needed images and starts Plone.
+
 
 ## Access Plone via Browser
 
 After startup, go to `http://plone.localhost/` and you should see the site.
 
+
 ## Shutdown and cleanup
 
-The command docker-compose down removes the containers and default network, but preserves the Plone database.
+The command `docker-compose down` removes the containers and default network, but preserves the Plone database.
 
-The command docker-compose down --volumes removes the containers, default network, and the Plone database.
+The command `docker-compose down --volumes` removes the containers, default network, and the Plone database.