Merge "docs: Add doc for release process"
diff --git a/docs/images/perfetto-ui-channel-toggle.png b/docs/images/perfetto-ui-channel-toggle.png
new file mode 100644
index 0000000..e530c0d
--- /dev/null
+++ b/docs/images/perfetto-ui-channel-toggle.png
Binary files differ
diff --git a/docs/images/perfetto-ui-channel.png b/docs/images/perfetto-ui-channel.png
new file mode 100644
index 0000000..aed8ac4
--- /dev/null
+++ b/docs/images/perfetto-ui-channel.png
Binary files differ
diff --git a/docs/images/perfetto-ui-version.png b/docs/images/perfetto-ui-version.png
new file mode 100644
index 0000000..00b523e
--- /dev/null
+++ b/docs/images/perfetto-ui-version.png
Binary files differ
diff --git a/docs/toc.md b/docs/toc.md
index a9e4d58..b9f8b9c 100644
--- a/docs/toc.md
+++ b/docs/toc.md
@@ -41,6 +41,7 @@
* [Perfetto UI](visualization/perfetto-ui.md)
* [Visualising large traces](visualization/large-traces.md)
* [Deep linking to Perfetto UI](visualization/deep-linking-to-perfetto-ui.md)
+ * [Perfetto UI release process](visualization/perfetto-ui-release-process.md)
* [Core concepts](#)
* [Trace configuration](concepts/config.md)
diff --git a/docs/visualization/perfetto-ui-release-process.md b/docs/visualization/perfetto-ui-release-process.md
new file mode 100644
index 0000000..a154a32
--- /dev/null
+++ b/docs/visualization/perfetto-ui-release-process.md
@@ -0,0 +1,39 @@
+# Perfetto UI Release Process
+
+The UI has three release channels which are configured by the [channels.json](https://github.com/google/perfetto/blob/master/ui/release/channels.json) file. The channels are:
+- `stable`, the version visitors to ui.perfetto.dev received by default. Updated every four weeks.
+- `canary`, a less stable but fresher release. Updated every 1-2 weeks.
+- `autopush`, the current HEAD version of the UI. Unstable.
+
+The release process is based around a four week cycle.
+- Week 1: Update `canary` to `HEAD`
+- Week 2: Update `canary` to `HEAD`
+- Week 3: Cherry-pick bug fixes to `canary`
+- Week 4: Update `stable` to current `canary`, update `canary` to `HEAD`
+
+After the fourth week the cycle repeats from week one.
+
+## Changing release channel
+
+NOTE: The channel setting is persistent across page reloads.
+
+The channel the UI is currently using is displayed in the top left corner.
+If the tag after the logo shows `autopush` or `canary` that is the current channel
+and if no tag is displayed the current channel is `stable`.
+
+
+
+To change the channel the UI is using between `stable` and `canery` you can use the toggle on the [entrance page](https://ui.perfetto.dev).
+
+
+
+To change to the `autopush` channel open devtools and enter `localStorage.setItem('perfettoUiChannel', 'autopush');` then reload.
+
+## Which version am I using?
+
+You can see the version of the UI you are currently using in the bottom left hand corner of the UI.
+
+
+
+Clicking on the version number takes you to Github where you can see which commits are part of this version. The version number format is `v<Perfetto version>.0.<Commits since that version>`.
+
