From 3a46819287b7277df0054da1a21497d64c46e327 Mon Sep 17 00:00:00 2001
From: Chris Roos <chris@seagul.co.uk>
Date: Mon, 12 Oct 2015 13:13:39 +0100
Subject: [PATCH] Add documentation about deploying

---
 README.md        |  1 +
 doc/deploying.md | 53 ++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 54 insertions(+)
 create mode 100644 doc/deploying.md

diff --git a/README.md b/README.md
index e2805f6bc34..6fab1c6be27 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,7 @@ Read more in [a blog post](https://gds.blog.gov.uk/2012/02/16/smart-answers-are-
 * Process
   * [Archiving a Smart Answer](doc/archiving.md)
   * [Deploying changes for Factcheck](doc/factcheck.md)
+  * [Deploying to production](doc/deploying.md)
   * [Merging pull requests from the content team](doc/merging-content-prs.md)
 * Development
   * Adding [content-ids](doc/content-ids.md) to Smart Answers.
diff --git a/doc/deploying.md b/doc/deploying.md
new file mode 100644
index 00000000000..12db11fb371
--- /dev/null
+++ b/doc/deploying.md
@@ -0,0 +1,53 @@
+## Create the Release in GitHub
+
+### 1. Find the latest release
+
+Open the [list of releases][smart-answers-releases] and make a note of the name of the most recent release (referred to as `$RELEASE-TAG` below).
+
+#### NOTE. Jenkins and releases
+
+After a successful build of the master branch on Jenkins:
+
+* Jenkins updates the `release` branch to point at HEAD
+* Jenkins creates a `release_nnnn` tag pointing at HEAD
+
+
+### 2. Review the changes waiting to be deployed to production
+
+Open "https://github.com/alphagov/smart-answers/compare/deployed-to-production...$RELEASE-TAG".
+
+Open each of the merged Pull Requests that are waiting to be deployed and ensure that the description contains details of the expected changes.
+
+
+### 3. Update the latest release on GitHub
+
+Open "https://github.com/alphagov/smart-answers/releases/tag/$RELEASE-TAG".
+
+Click "Edit release".
+
+Leave the "Release title" blank.
+
+Set the description to:
+
+```
+## Changes to deploy
+
+https://github.com/alphagov/smart-answers/compare/deployed-to-production...$RELEASE-TAG
+
+## Main changes
+
+TODO: List each of the Pull Requests that contain user facing changes here, for example:
+
+* https://github.com/alphagov/smart-answers/pull/nnn - <title-of-pull-request>
+```
+
+## Create the deployment calendar event
+
+1. Add an event to the "GOVUK Release Calender"
+
+  * Title: "Smart Answers (2nd line required)"
+  * Time: <The time you'd like to deploy>
+  * Duration: 30 minutes
+  * Description: https://github.com/alphagov/smart-answers/releases/tag/$RELEASE-TAG
+
+[smart-answers-releases]: https://github.com/alphagov/smart-answers/releases