From 0718c623418801b3bcf1d3512e7f3dcdaf660272 Mon Sep 17 00:00:00 2001
From: Adam Spiers <aspiers@suse.com>
Date: Wed, 22 Feb 2017 11:46:39 -0500
Subject: [PATCH] explain how to subscribe to a particular launchpad tag

Launchpad allows email subscriptions to all activity relating to
particular launchpad bug tags. This is a particularly handy tool for
docs liasons, so document it.

Change-Id: Ia0e7cb2e4f00af580e4e3b10952807e96bcd7a90
---
 doc/contributor-guide/source/doc-bugs.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/doc/contributor-guide/source/doc-bugs.rst b/doc/contributor-guide/source/doc-bugs.rst
index 1374b76823..e195468d5a 100644
--- a/doc/contributor-guide/source/doc-bugs.rst
+++ b/doc/contributor-guide/source/doc-bugs.rst
@@ -177,3 +177,19 @@ bugs:
   <https://bugs.launchpad.net/openstack-api-site>`_
 * `low hanging fruit documentation bugs
   <https://bugs.launchpad.net/openstack-manuals/+bugs?field.tag=low-hanging-fruit>`_
+
+Tracking bugs by tag
+--------------------
+
+If you need to regularly track activity relating to particular tags,
+you can set up email subscriptions by visiting `the subscriptions page
+of the launchpad project
+<https://bugs.launchpad.net/openstack-manuals/+subscriptions>`_:
+
+1. Select :guilabel:`Add a subscription`.
+2. Select the option to receive mail for bugs affecting the project
+   that :guilabel:`are added or changed in any way`.
+3. Check the :guilabel:`Bugs must match this filter` checkbox.
+4. Select the :guilabel:`Tags` subsection.
+5. Populate the tag(s) you want to track.
+6. Create the subscription.