From 653fcdaed20fdae1e571fc8b2a961309b41af59b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marc=20Sch=C3=B6chlin?= <schoechlin@osb-alliance.com>
Date: Mon, 17 Jun 2024 12:53:24 +0200
Subject: [PATCH] Improve network documentation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Marc Schöchlin <schoechlin@osb-alliance.com>
---
 docs/guides/deploy-guide/services/network.md | 29 ++++++++++----------
 1 file changed, 15 insertions(+), 14 deletions(-)

diff --git a/docs/guides/deploy-guide/services/network.md b/docs/guides/deploy-guide/services/network.md
index c397f7de16..e503ca5c8f 100644
--- a/docs/guides/deploy-guide/services/network.md
+++ b/docs/guides/deploy-guide/services/network.md
@@ -5,6 +5,20 @@ sidebar_position: 15
 
 # Network
 
+Two options are available for installing the Openstack network.
+
+* Open Virtual Network with Open vSwitch:
+  * the default, recommended
+  * configuration value `ovn`
+* Open vSwitch:
+  * configuration value `openvswitch`
+
+The selected option is configured in the following file:
+```yaml title="environments/kolla/configuration.yml"
+# neutron
+neutron_plugin_agent: "ovn"
+```
+
 1. Open vSwitch (OVS)
 
    ```
@@ -12,20 +26,7 @@ sidebar_position: 15
    osism apply openvswitch
    ```
 
-2. Open Virtual Network (OVN)
-
-   In `environments/kolla/configuration.yml` the parameter `neutron_plugin_agent` is set to
-   `ovn` if OVN is used as a network plugin. The parameter is set to `ovn` by default in the
-   Cookiecutter.
-
-   ```yaml title="environments/kolla/configuration.yml"
-   # neutron
-   neutron_plugin_agent: "ovn"
-   ```
-
-   Otherwise the network plugin is set to `openvswitch`.
-   If the `neutron_plugin_agent` is set to `openvswitch`, this step does not need to be done.
-
+2. Optional: Open Virtual Network (OVN)
    Before the deployment of OVN, the deployment of Open vSwitch must already have been done.
 
    ```