Merge lp:~brendan-donegan/checkbox/release_docs_improve into lp:checkbox

[Brendan Donegan]

Please DO NOT MERGE until https://code.launchpad.net/~brendan-donegan/checkbox/manage_release/+merge/204478 has been succesfully merged.

A couple of simple improvements to the release process documentation:

1.) Link to the Certification Self-Testing guide on C3 so that people know how to run checkbox-certification-client.
2.) Strip out all the verbose release cutting steps and show people how to use manage_release (which is in the branch above)

[lp:~brendan-donegan/checkbox/release_docs_improve]

2637. By Brendan Donegan on 2014-02-05

Replace the very verbose command line steps which were used to cut the release with simple calls to the utility script manage_release.

Signed-off-by: Brendan Donegan <email address hidden>

Unmerged revisions

2637. By Brendan Donegan on 2014-02-05

Replace the very verbose command line steps which were used to cut the release with simple calls to the utility script manage_release.

Signed-off-by: Brendan Donegan <email address hidden>

2636. By Brendan Donegan on 2014-02-04

Point to the Certification Self-Testing guide in the release process documentation where we talk about how to test the release. Note that it is NOT necessary to have an account on C3 to download the document, so we don't need to advise about that.

=== modified file 'checkbox-ng/docs/release.rst'
--- checkbox-ng/docs/release.rst	2014-01-29 14:04:54 +0000
+++ checkbox-ng/docs/release.rst	2014-02-05 16:25:18 +0000
@@ -66,31 +66,17 @@
 
 In order to cut the release, we have to merge the changes from trunk into the
 release branch, commit them with a suitable message and update the changelog in
-trunk so that future changes go under the correct version. For each combination
-of branches shown above, do the following (the example uses ``lp:checkbox`` and
-``lp:checkbox/release``)::
-
-    bzr branch lp:checkbox/release checkbox-release
-    bzr branch lp:checkbox checkbox-trunk
-    cd checkbox-release
-    current_stable=`head -n1 $(find . -name 'changelog') | grep -oP '(?<=\().*(?=\))'`
-    bzr merge lp:checkbox
-
-at this point if no changes (other than one to ``debian/changelog``) get merged
-in then we do not perform a release of the package in question. In practice
-this often happens with ``checkbox-certification`` but never with
-``checkbox``::
-
-    bzr commit -m "Merged in changes from rev$(bzr revno -r tag:$current_stable lp:checkbox) to rev$(bzr revno lp:checkbox) from lp:checkbox"
-    bzr push lp:checkbox/release
-    cd `find . -name 'debian'`; cd ..
-    bzr tag `head -n1 debian/changelog | grep -oP '(?<=\().*(?=\))'`
-    dch -r (save modified changelog)
-    dch -i -U 'Incremented changelog'
-    debcommit
-    bzr push lp:checkbox
-
-The last step in the process is to perform a build of the packages in the
+trunk so that future changes go under the correct version. Luckily we have a
+script which does this for us, making this process fast and reliable.
+
+Get a copy of the checkbox source and run the following from the root::
+
+  support/manage_release prepare checkbox
+  support/manage_release prepare checkbox-certification
+  support/manage_release prepare checkbox-packaging
+
+These take a little while to run, but once they are done the last step in the 
+process is to simply perform a build of the packages in the
 ``ppa:checkbox-dev/testing PPA``. To do this we need to go to the recipe pages
 for the ``checkbox`` and/or ``checkbox-certification`` release branches.
 
@@ -155,7 +141,10 @@
 to be tested is ``checkbox-certification-client`` and
 ``checkbox-certification-server`` which form the basis for CE QAs OEM specific
 versions of CheckBox. CheckBox certification server is tested in the CI loop
-CheckBox certification client needs to be tested manually.
+CheckBox certification client needs to be tested manually. This should be done
+according to the instructions in the `Certification Self-Testing Guide
+<https://certification.canonical.com/static/docs/Ubuntu_Desktop_Certified_
+Hardware_Self-Testing_Guide.pdf>`_.
 
 Release Meeting
 ===============