Merge ~jugmac00/launchpad:how-to-resurrect-dogfood into launchpad:master

[Jürgen Gmach]

Create "Resurrecting dogfood" how-to

[Colin Watson (cjwatson)]

review: Approve

diff --git a/doc/how-to/resurrect-dogfood.rst b/doc/how-to/resurrect-dogfood.rst
new file mode 100644
index 0000000..c78ff77
--- /dev/null
+++ b/doc/how-to/resurrect-dogfood.rst
@@ -0,0 +1,19 @@
+=========================================
+Resurrecting dogfood/development instance
+=========================================
+
+`dogfood <https://dogfood.paddev.net/>`_ is an instance of Launchpad,
+run by the Launchpad developers.
+
+When the site is not available, please activate Canonical's VPN and execute
+the following commands:
+
+.. code:: bash
+
+    $ ssh <user>@labbu.canonical.com
+    $ sudo -iu launchpad
+    $ upgrade-dogfood-launchpad
+
+.. note:
+
+    Please note that this may take up to, or even more than 10 minutes.
diff --git a/doc/index.rst b/doc/index.rst
index f967be6..aad3908 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -35,6 +35,7 @@ How-to Guides
    how-to/avoid-debugging-issues
    how-to/apply-schema-changes
    how-to/use-updated-dependency
+   how-to/resurrect-dogfood
 
 Explanation
 ===========