Merge "doc - fix zuul section title and add ref to ext ZE doc"

Author: Microzuul CI

doc/deployment/index.md

@@ -13,6 +13,7 @@ and managing a Software Factory Custom Resource through SF-Operator.
 1. Services documentation
     - [Nodepool](./nodepool.md)
     - [Zuul](./zuul.md)
+    - [Zuul external Executor](./external-executor.md)
     - [Logserver](./logserver.md)
     - [Backing services](./backing_services.md)
 1. [Setting up certificates](./certificates.md)

doc/deployment/zuul.md

@@ -1,4 +1,4 @@
-.# Zuul
+# Zuul
 
 Here you will find information about managing the Zuul service when deployed with the SF Operator.
 It does not replace [Zuul's documentation](https://zuul-ci.org/docs/zuul/latest/),

mkdocs.yml

@@ -64,65 +64,66 @@ extra:
 nav:
   - Home: README.md
   - Operator:
-    - operator/index.md
-    - Getting started: operator/getting_started.md
-    - Uninstall: operator/uninstall.md
+      - operator/index.md
+      - Getting started: operator/getting_started.md
+      - Uninstall: operator/uninstall.md
   - Deploy:
-    - deployment/index.md
-    - Getting started: deployment/getting_started.md
-    - Configuration repository: deployment/config_repository.md
-    - Services reference:
-      - Backing services: deployment/backing_services.md
-      - Log server: deployment/logserver.md
-      - Nodepool: deployment/nodepool.md
-      - Zuul: deployment/zuul.md
-    - TLS:
-      - Setting up certificates: deployment/certificates.md
-      - Adding third-party certificates into the CA trust chain: deployment/corporate-certificates.md
-    - Monitoring: deployment/monitoring.md
-    - Logging: deployment/logging.md
-    - Deleting a deployment: deployment/delete.md
+      - deployment/index.md
+      - Getting started: deployment/getting_started.md
+      - Configuration repository: deployment/config_repository.md
+      - Services reference:
+          - Backing services: deployment/backing_services.md
+          - Log server: deployment/logserver.md
+          - Nodepool: deployment/nodepool.md
+          - Zuul: deployment/zuul.md
+          - Zuul External Executor: deployment/external-executor.md
+      - TLS:
+          - Setting up certificates: deployment/certificates.md
+          - Adding third-party certificates into the CA trust chain: deployment/corporate-certificates.md
+      - Monitoring: deployment/monitoring.md
+      - Logging: deployment/logging.md
+      - Deleting a deployment: deployment/delete.md
   - User:
-    - user/index.md
-    - Services configuration:
-      - Nodepool: user/nodepool_config_repository.md
-      - Zuul tenants: user/zuul_config_repository.md
-  - Develop: 
-    - developer/index.md
-    - Contributing: developer/CONTRIBUTING.md
-    - Getting started: developer/getting_started.md
-    - Developing on a MicroShift instance: developer/microshift.md
-    - Testing: developer/testing.md
-    - Releasing: developer/release.md
-    - Hacking images: developer/images.md
-    - Contributing: developer/CONTRIBUTING.md
-    - Howtos:
-      - developer/howtos/index.md
-    - Troubleshooting: developer/troubleshooting.md
-  - Reference: 
-    - reference/index.md
-    - Decision Records (ADR):
-      - reference/adr/index.md
-      - reference/adr/0000-use-markdown-any-decision-records.md
-      - reference/adr/0001-operator-config.md
-      - reference/adr/0002-zuul-system-config.md
-      - reference/adr/0003-config-update.md
-      - reference/adr/0004-zuul-main.md
-      - reference/adr/0005-ops-tooling.md
-      - reference/adr/0006-monitoring.md
-      - reference/adr/0007-edge-cert.md
-      - reference/adr/0008-config-jobs.md
-      - reference/adr/0009-database-agnosticity.md
-      - reference/adr/0010-zuul-operator-usage.md
-      - reference/adr/0011-backup-and-restore.md
-      - reference/adr/0011-nodepool-builder.md
-      - reference/adr/0012-CLI-overhaul.md
-      - reference/adr/0013-more-CLI-features.md
-      - reference/adr/0014-external-zuul-executor.md
-     # - Template: reference/adr/adr-template.md
-    - Custom Resource Definitions: deployment/crds.md
-    - API:
-      - reference/api/index.md
-    - CLI:
-      - reference/cli/index.md
-    - CHANGELOG: reference/CHANGELOG.md
+      - user/index.md
+      - Services configuration:
+          - Nodepool: user/nodepool_config_repository.md
+          - Zuul tenants: user/zuul_config_repository.md
+  - Develop:
+      - developer/index.md
+      - Contributing: developer/CONTRIBUTING.md
+      - Getting started: developer/getting_started.md
+      - Developing on a MicroShift instance: developer/microshift.md
+      - Testing: developer/testing.md
+      - Releasing: developer/release.md
+      - Hacking images: developer/images.md
+      - Contributing: developer/CONTRIBUTING.md
+      - Howtos:
+          - developer/howtos/index.md
+      - Troubleshooting: developer/troubleshooting.md
+  - Reference:
+      - reference/index.md
+      - Decision Records (ADR):
+          - reference/adr/index.md
+          - reference/adr/0000-use-markdown-any-decision-records.md
+          - reference/adr/0001-operator-config.md
+          - reference/adr/0002-zuul-system-config.md
+          - reference/adr/0003-config-update.md
+          - reference/adr/0004-zuul-main.md
+          - reference/adr/0005-ops-tooling.md
+          - reference/adr/0006-monitoring.md
+          - reference/adr/0007-edge-cert.md
+          - reference/adr/0008-config-jobs.md
+          - reference/adr/0009-database-agnosticity.md
+          - reference/adr/0010-zuul-operator-usage.md
+          - reference/adr/0011-backup-and-restore.md
+          - reference/adr/0011-nodepool-builder.md
+          - reference/adr/0012-CLI-overhaul.md
+          - reference/adr/0013-more-CLI-features.md
+          - reference/adr/0014-external-zuul-executor.md
+        # - Template: reference/adr/adr-template.md
+      - Custom Resource Definitions: deployment/crds.md
+      - API:
+          - reference/api/index.md
+      - CLI:
+          - reference/cli/index.md
+      - CHANGELOG: reference/CHANGELOG.md