diff --git a/doc/source/mailing-list.rst b/doc/source/mailing-list.rst
index 2fec34ea..a64fd996 100644
--- a/doc/source/mailing-list.rst
+++ b/doc/source/mailing-list.rst
@@ -1,16 +1,13 @@
 .. _mailing_list:
 
-=============
-Mailing lists
-=============
+============
+Mailing list
+============
 
 Please use the mailing list when possible as it makes the information
 discussed more readily available so that others who have the same
 question can search for (and find) those answers.
 
--  Dev discussions:
-   `openstack-dev@lists.openstack.org <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev>`__
-   with ``[charms]`` tag.
--  Usage discussions:
-   `openstack-operators@lists.openstack.org <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators>`__
-   with ``[charms]`` tag.
+All communication regarding charms should contain **[charms]** in the subject line when sending to the `mailing_list`_.
+
+.. _mailing list: http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-discuss