Add router provisioning

Signed-off-by: Karel van Klink <karel.vanklink@geant.org>

docs/glossary.md

@@ -34,8 +34,14 @@ MPLS
 MTTR
 : Mean Time To Repair
 
+OOB
+: Out-of-band
+
 PoP
 : Point of Presence
 
 SDP
 : Service Delivery Point
+
+WFO
+: Workflow Orchestrator

docs/index.md

@@ -5,9 +5,9 @@ The focus of this platform is configuration management and service orchestration
 
 ## Table of contents
 ```{toctree}
+:maxdepth: 2
 overview/index.md
 architecture/index.md
-processes/node_provisioning.md
-processes/deploy_router.md
+processes/index.md
 glossary.md
 ```

docs/processes/deploy_router.md

+## Router deployment
+
+From a bird's-eye view, the process of deploying a new router in the network is as follows:
+
+1. Manually configure the router such that it's reachable from out-of-band ({term}`OOB`).
+2. Upgrade the router to the most recent OS.
+3. Deploy base configuration.
+4. Configure trunks to connect the router to the network.
+5. Update the protocol meshes (such as {term}`iBGP`).
+6. Promote the router to the production environment.
+
+```{figure} ../static/WFO_deploy_router.png
+:alt: Diagram that displays the steps that Workflow Orchestrator takes to provision a new router. 
+
+{term}`WFO` provisions a new router by following the steps shown here.
+```

docs/processes/index.md

+# Processes
+
+This section describes the mechanics for deploying different types of devices in the GÉANT network.
+
+```{include} node_provisioning.md
+```
+
+```{include} deploy_router.md
+```

docs/processes/node_provisioning.md

-# Node provisioning
+## Node provisioning
 
-This section describes the mechanics for deploying a new node in the GÉANT network. A node can either be a router, a
-switch, or a terminal server.
-
-In general -- as laid out more extensively 
+A node can either be a router, a switch, or a terminal server. In general -- as laid out more extensively 
 [here](https://wiki.geant.org/display/NETENG/001+-+Topology+and+physical+layout) (behind login) -- a {term}`PoP` 
 consists of:
 

docs/vale/styles/Vocab/geant-jargon/accept.txt

@@ -14,3 +14,6 @@ AAA
 GÉANT Automation Platform
 GAP
 [Mm]ultipoint
+WFO
+BGP
+FXP