From c5d3a89d7f17d26d41d78d01b71b0733c61e4329 Mon Sep 17 00:00:00 2001
From: "backport-actions-token[bot]"
 <87506591+backport-actions-token[bot]@users.noreply.github.com>
Date: Fri, 11 Mar 2022 14:00:13 -0600
Subject: [PATCH] expand enterprise route reference (#3118) (#3132)

Co-authored-by: Alex Fornuto <afornuto@pomerium.com>
---
 docs/enterprise/console-settings.yaml | 11 +++++++++++
 docs/enterprise/reference/manage.md   | 11 +++++++++++
 2 files changed, 22 insertions(+)

diff --git a/docs/enterprise/console-settings.yaml b/docs/enterprise/console-settings.yaml
index 42ee5fad1..9539bfb2a 100644
--- a/docs/enterprise/console-settings.yaml
+++ b/docs/enterprise/console-settings.yaml
@@ -37,6 +37,17 @@ settings:
       - name: "Routes"
         doc: |
           A [Route](/enterprise/concepts.md#routes) defines how to access a service running behind Pomerium. This includes authentication (both for Pomerium and passed through to the service), rewrites, header management, load balancing, etc.
+
+          When first installing Pomerium Enterprise, users may want to import existing routes from the open-source Pomerium core. The **Import Routes** button accepts the open-source `config.yaml` file and imports routes from it to Pomerium Enterprise.
+
+          From the main Routes page you can view and manage existing routes. From the table of routes you can:
+            - filter visible routes,
+            - delete one or more routes,
+            - move routes between Namespaces,
+            - export one or more route definitions to a CSV file,
+            - create a JSON-formatted policy report on one or more selected routes.
+
+          The sections below cover the options available when creating or editing a route.
         settings:
           - name: "General"
             doc: |
diff --git a/docs/enterprise/reference/manage.md b/docs/enterprise/reference/manage.md
index 02ff06708..b6f3ea5ed 100644
--- a/docs/enterprise/reference/manage.md
+++ b/docs/enterprise/reference/manage.md
@@ -13,6 +13,17 @@ meta:
 
 A [Route](/enterprise/concepts.md#routes) defines how to access a service running behind Pomerium. This includes authentication (both for Pomerium and passed through to the service), rewrites, header management, load balancing, etc.
 
+When first installing Pomerium Enterprise, users may want to import existing routes from the open-source Pomerium core. The **Import Routes** button accepts the open-source `config.yaml` file and imports routes from it to Pomerium Enterprise.
+
+From the main Routes page you can view and manage existing routes. From the table of routes you can:
+  - filter visible routes,
+  - delete one or more routes,
+  - move routes between Namespaces,
+  - export one or more route definitions to a CSV file,
+  - create a JSON-formatted policy report on one or more selected routes.
+
+The sections below cover the options available when creating or editing a route.
+
 
 ### General