diff --git a/README.md b/README.md
index 0ec559321..7b2d87501 100644
--- a/README.md
+++ b/README.md
@@ -14,8 +14,8 @@ For Windows 10 and 11. No admin rights required.
## Access Linux and Windows VMs from anywhere
-
-
+
+
IAP Desktop uses [Identity-Aware-Proxy (IAP)](https://cloud.google.com/iap/docs/tcp-forwarding-overview) to connect to VM instances so that you can:
@@ -35,8 +35,8 @@ The application automatically manages IAP TCP tunnels for you, and protects them
## Connect to Windows VMs with Remote Desktop
-
-
+
+
IAP Desktop is a [full-featured Remote Desktop client](https://googlecloudplatform.github.io/iap-desktop/connect-windows/) that lets you:
@@ -50,14 +50,14 @@ To help you authenticate to Windows VMs, IAP Desktop can:
* Automatically generate Windows credentials by using the Compute Engine guest agent environment
* Encrypt and store your Windows credentials locally
-:arrow_forward: [Show screencast](doc/images/RemoteDesktop_1400.gif?raw=true)
+:arrow_forward: [Show screencast](doc/site/sources/docs/images/screenshots/RemoteDesktop_1400.gif?raw=true)
## Connect to Linux VMs with SSH
-
-
+
+
IAP Desktop [includes an SSH client and terminal](https://googlecloudplatform.github.io/iap-desktop/connect-linux/) so that you can:
@@ -71,15 +71,15 @@ To help you authenticate to Linux VMs, IAP Desktop can:
* Use OS Login [2-factor authentication](https://cloud.google.com/compute/docs/oslogin/set-up-oslogin)
* Store our SSH keys locally using Windows CNG
-:arrow_forward: [Show screencast](doc/images/SSH_1400.gif?raw=true)
+:arrow_forward: [Show screencast](doc/site/sources/docs/images/screenshots/SSH_1400.gif?raw=true)
## Manage VMs across projects
-
-
+
+
IAP Desktop gives you a consolidated view of your VMs and lets you:
@@ -91,15 +91,15 @@ IAP Desktop gives you a consolidated view of your VMs and lets you:
* Perform other common operations such as starting or stopping VMs
-:arrow_forward: [Show screencast](doc/images/Manage_1400.gif?raw=true)
+:arrow_forward: [Show screencast](doc/site/sources/docs/images/screenshots/Manage_1400.gif?raw=true)
## Connect to SQL Server and other server applications
-
-
+
+
You can use IAP Desktop to let client applications connect to your Google Cloud VMs through IAP:
diff --git a/doc/images/Architecture.svg b/doc/images/Architecture.svg
deleted file mode 100644
index 2046fa62b..000000000
--- a/doc/images/Architecture.svg
+++ /dev/null
@@ -1,606 +0,0 @@
-
-
-
-
diff --git a/doc/images/Client_350.png b/doc/images/Client_350.png
deleted file mode 100644
index 7f3fe6e74..000000000
Binary files a/doc/images/Client_350.png and /dev/null differ
diff --git a/doc/images/Client_700.png b/doc/images/Client_700.png
deleted file mode 100644
index dd0679c7c..000000000
Binary files a/doc/images/Client_700.png and /dev/null differ
diff --git a/doc/images/Manage_1024.gif b/doc/images/Manage_1024.gif
deleted file mode 100644
index 23bb935ae..000000000
Binary files a/doc/images/Manage_1024.gif and /dev/null differ
diff --git a/doc/images/Manage_1400.gif b/doc/images/Manage_1400.gif
deleted file mode 100644
index fb89adfb8..000000000
Binary files a/doc/images/Manage_1400.gif and /dev/null differ
diff --git a/doc/images/Manage_350.gif b/doc/images/Manage_350.gif
deleted file mode 100644
index a63946aee..000000000
Binary files a/doc/images/Manage_350.gif and /dev/null differ
diff --git a/doc/images/Manage_350.png b/doc/images/Manage_350.png
deleted file mode 100644
index 5cdcc42e7..000000000
Binary files a/doc/images/Manage_350.png and /dev/null differ
diff --git a/doc/images/Manage_512.gif b/doc/images/Manage_512.gif
deleted file mode 100644
index cf666ac09..000000000
Binary files a/doc/images/Manage_512.gif and /dev/null differ
diff --git a/doc/images/Overview.png b/doc/images/Overview.png
deleted file mode 100644
index d1dbb8beb..000000000
Binary files a/doc/images/Overview.png and /dev/null differ
diff --git a/doc/images/RemoteDesktop_1400.gif b/doc/images/RemoteDesktop_1400.gif
deleted file mode 100644
index 7eb785d37..000000000
Binary files a/doc/images/RemoteDesktop_1400.gif and /dev/null differ
diff --git a/doc/images/RemoteDesktop_350.png b/doc/images/RemoteDesktop_350.png
deleted file mode 100644
index a9d428e35..000000000
Binary files a/doc/images/RemoteDesktop_350.png and /dev/null differ
diff --git a/doc/images/SSH_1400.gif b/doc/images/SSH_1400.gif
deleted file mode 100644
index 5d90d1e47..000000000
Binary files a/doc/images/SSH_1400.gif and /dev/null differ
diff --git a/doc/images/SSH_350.gif b/doc/images/SSH_350.gif
deleted file mode 100644
index 3ee574047..000000000
Binary files a/doc/images/SSH_350.gif and /dev/null differ
diff --git a/doc/images/SSH_350.png b/doc/images/SSH_350.png
deleted file mode 100644
index 0d5fb959c..000000000
Binary files a/doc/images/SSH_350.png and /dev/null differ
diff --git a/doc/images/Screenshot_1400.png b/doc/images/Screenshot_1400.png
deleted file mode 100644
index 5d3d755d6..000000000
Binary files a/doc/images/Screenshot_1400.png and /dev/null differ
diff --git a/doc/images/Screenshot_350.png b/doc/images/Screenshot_350.png
deleted file mode 100644
index 1b9afa12a..000000000
Binary files a/doc/images/Screenshot_350.png and /dev/null differ
diff --git a/doc/images/iapdesktop-animated-800.gif b/doc/images/iapdesktop-animated-800.gif
deleted file mode 100644
index 41f1160ba..000000000
Binary files a/doc/images/iapdesktop-animated-800.gif and /dev/null differ
diff --git a/doc/site/sources/docs/group-policy-reference.md b/doc/site/sources/docs/group-policy-reference.md
index 54d0724ba..aba141495 100644
--- a/doc/site/sources/docs/group-policy-reference.md
+++ b/doc/site/sources/docs/group-policy-reference.md
@@ -6,16 +6,18 @@ setting anymore.
IAP Desktop supports the following policies:
-| Policy | Default | Synopsis |
-| --------------------------------------------- | ------- |----------------------------------------------------------------------------------------- |
-| Enable update checks | On | Periodically check for updates on exit. |
-| Enable data sharing | Off | Share anonymous usage data to help Google improve and prioritize features. |
-| Enable BeyondCorp certificate-based access | Off | Secure connections to Google Cloud by using BeyondCorp certificate-based access. |
-| Enable Workforce Identity | - | Set provider to use for workforce identity federation. |
-| Enable Private Service Connect | Off | Use custom Private Service Connect endpoint to connect to connect to Google APIs. |
-| Enable HTTPS proxy | - | Set proxy server or autoconfiguration URL. |
-| SSH key type | - | Set key type to use for SSH public key authentication. |
-| SSH metadata key validity | - | Lifetime for SSH keys published to Compute Engine instance metadata and OS Login. |
+| Policy | Default | Synopsis |
+|--------------------------------------------|---------|-----------------------------------------------------------------------------------|
+| Enable update checks | On | Periodically check for updates on exit. |
+| Enable data sharing | Off | Share anonymous usage data to help Google improve and prioritize features. |
+| Enable BeyondCorp certificate-based access | Off | Secure connections to Google Cloud by using BeyondCorp certificate-based access. |
+| Enable Workforce Identity | - | Set provider to use for workforce identity federation. |
+| Enable Private Service Connect | Off | Use custom Private Service Connect endpoint to connect to connect to Google APIs. |
+| Enable HTTPS proxy | - | Set proxy server or autoconfiguration URL. |
+| SSH key type | - | Set key type to use for SSH public key authentication. |
+| SSH metadata key validity | - | Lifetime for SSH keys published to Compute Engine instance metadata and OS Login. |
+| Enable SFTP file access | On | Allow users to browse, upload, and download files using SFTP. |
+
For more information about using group policies to manage IAP Desktop, see
[Use group policies to manage IAP Desktop](group-policies.md).
diff --git a/doc/site/sources/docs/images/02-installer.png b/doc/site/sources/docs/images/02-installer.png
index d9f75280f..9913ab011 100644
Binary files a/doc/site/sources/docs/images/02-installer.png and b/doc/site/sources/docs/images/02-installer.png differ
diff --git a/doc/site/sources/docs/images/03-signin.png b/doc/site/sources/docs/images/03-signin.png
index 36ca1a5d2..8f9a7bfb2 100644
Binary files a/doc/site/sources/docs/images/03-signin.png and b/doc/site/sources/docs/images/03-signin.png differ
diff --git a/doc/site/sources/docs/images/screenshots/SSH_1400.gif b/doc/site/sources/docs/images/screenshots/SSH_1400.gif
index 5d90d1e47..d06f6d792 100644
Binary files a/doc/site/sources/docs/images/screenshots/SSH_1400.gif and b/doc/site/sources/docs/images/screenshots/SSH_1400.gif differ
diff --git a/doc/site/sources/docs/images/screenshots/SSH_1400.gif.mp4 b/doc/site/sources/docs/images/screenshots/SSH_1400.gif.mp4
new file mode 100644
index 000000000..6018b2c32
Binary files /dev/null and b/doc/site/sources/docs/images/screenshots/SSH_1400.gif.mp4 differ
diff --git a/doc/site/sources/docs/images/screenshots/SSH_350.png b/doc/site/sources/docs/images/screenshots/SSH_350.png
index 0d5fb959c..b674e8afe 100644
Binary files a/doc/site/sources/docs/images/screenshots/SSH_350.png and b/doc/site/sources/docs/images/screenshots/SSH_350.png differ
diff --git a/doc/site/sources/docs/troubleshooting-rdp.md b/doc/site/sources/docs/troubleshooting-rdp.md
index 95b12507a..4815b2b1b 100644
--- a/doc/site/sources/docs/troubleshooting-rdp.md
+++ b/doc/site/sources/docs/troubleshooting-rdp.md
@@ -2,7 +2,7 @@
## :material-message-alert: Copy/paste doesn't work
-**Symptom**: Unable to copy and paste text or files over RDP
+**Symptom**: You can't copy and paste text or files over RDP
This behavior can be caused by an invalid configuration or group policies.
diff --git a/doc/site/sources/docs/troubleshooting-ssh.md b/doc/site/sources/docs/troubleshooting-ssh.md
index 2f8762c63..1687bc84f 100644
--- a/doc/site/sources/docs/troubleshooting-ssh.md
+++ b/doc/site/sources/docs/troubleshooting-ssh.md
@@ -79,4 +79,14 @@ To use ephemeral keys, do the following:
1. Click **OK**.
When you use an ephemeral key and IAP Desktop publishes the public key to OS Login or metadata, it
-automatically limits the lifetime of the key to one day.
\ No newline at end of file
+automatically limits the lifetime of the key to one day.
+
+
+## :material-message-alert: Copying text from the terminal stops working when running `vim`
+
+**Symptom**: Copying text from the terminal stops working when running `vim` (or certain other programs).
+
+This behavior is expected and a result of the way `vim` handles mouse input. To copy text from `vim`,
+use the [`set mouse=r` option](https://vimdoc.sourceforge.net/htmldoc/options.html#'mouse'), or
+hold the **Shift** key while coping text.
+