Adds a recommended workflow page.

Author: simonbrowndotje

usage/authoring.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Authoring
-parent: Usage
+parent: Usage and Workflow
 nav_order: 2
 permalink: /usage/authoring
 ---

usage/enterprise.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Enterprise
-parent: Usage
+parent: Usage and Workflow
 nav_order: 4
 permalink: /usage/enterprise
 ---

usage/index.md

@@ -1,17 +1,18 @@
 ---
 layout: default
-title: Usage
+title: Usage and Workflow
 nav_order: 6
 has_children: true
 permalink: /usage
 has_toc: false
 ---
 
-# Usage
+# Usage and Workflow
 
 Given the variety of [products](/products) and [community tooling](/community), there are many ways in which the
 Structurizr tooling can be used. This section will look at usage from a few different angles:
 
+- [Recommended workflow](/usage/workflow)
 - [Workspace authoring](/usage/authoring)
 - [Workspace rendering](/usage/rendering)
 - [Team usage](/usage/team)

usage/rendering.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Rendering
-parent: Usage
+parent: Usage and Workflow
 nav_order: 3
 permalink: /usage/rendering
 ---

usage/team.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Team
-parent: Usage
+parent: Usage and Workflow
 nav_order: 3
 permalink: /usage/team
 ---

usage/workflow.md

@@ -0,0 +1,16 @@
+---
+layout: default
+title: Recommended workflow
+parent: Usage and Workflow
+nav_order: 1
+permalink: /usage/workflow
+---
+
+# Recommended workflow
+
+There are many ways in which the Structurizr tooling can be used,
+but the simplest and recommended workflow is as follows:
+
+1. Author workspaces locally using a combination of the [Structurizr DSL](/dsl), [Structurizr Lite](/lite) ([quickstart](/lite/quickstart)), and one of the [VS Code/IDE extensions](/community#structurizr-dsl-editor-and-ide-plugins).
+2. Store DSL files in version control (e.g. git).
+3. Publish workspaces to an [on-premises installation](/onpremises) or the [cloud service](/cloud) via the [Structurizr CLI](/cli) if the diagrams/documentation need to be viewed by a wider audience. This can be done manually or via a CI/CD build pipeline.