Reorganize deployment page and add details about copy and paste

docs/source/deployment/deploy_sre.md

@@ -75,14 +75,18 @@ sre:
 
 ::::
 
-:::{admonition} Supported Azure regions
-:class: dropdown important
+### Configuration guidance
+
+#### Choosing an Azure region
 
 Some of the SRE resources are not available in all Azure regions.
 
 - Workspace virtual machines use zone redundant storage managed disks which have [limited regional availability](https://learn.microsoft.com/en-us/azure/virtual-machines/disks-redundancy).
 - Some shares mounted on workspace virtual machines require premium file shares which have [limited regional availability](https://learn.microsoft.com/en-us/azure/storage/files/redundancy-premium-file-shares).
 
+:::{admonition} Supported Azure regions
+:class: dropdown important
+
 The regions which satisfy all requirements are,
 
 - Australia East
@@ -117,6 +121,8 @@ The regions which satisfy all requirements are,
 
 :::
 
+#### Choosing a VM SKU
+
 :::{hint}
 See [here](https://learn.microsoft.com/en-us/azure/virtual-machines/sizes/) for a full list of valid Azure VM SKUs.
 :::
@@ -170,6 +176,28 @@ As some general recommendations,
 
 :::
 
+### Copy and paste
+
+The [Guacamole clipboard](https://guacamole.apache.org/doc/gug/using-guacamole.html#using-the-clipboard) provides an interface between the local clipboard and the clipboard on the remote workspaces.
+Only text is allowed to be passed through the Guacamole clipboard.
+
+Copy and pasting of text to or from SRE workspaces via the Guacamole clipboard can be configured with the `allow_copy` and `allow_paste` settings.
+
+`allow_copy` allows users to copy text from an SRE workspace to the Guacamole clipboard.
+
+`allow_paste` allows users to paste text into an SRE workspace from the Guacamole clipboard.
+
+These options have no impact on the ability to use copy and paste within a workspace.
+
+The impact of setting each of these options is detailed in the below table.
+
+| allow_copy | allow_paste | Copy/paste within workspace | Copy/paste between workspaces | Copy to local machine | Paste from local machine |
+|--------|--------|--------|--|---|--|
+| true | true | yes | yes | yes | yes |
+| true | false |  yes | no | yes | no |
+| false | true | yes | no | no | yes|
+| false | false | yes | no | no | no |
+
 ## Upload the configuration file
 
 - Upload the config to Azure. This will validate your file and report any problems.