Fixed #21213 -- Added docs for Django's mailing lists.

Added docs/internals/mailing-lists.txt documenting the use of django's
mailing lists. All references across docs changed to point to this page.

The referencing makes use of substitution because there's no way to make
a :ref: link in a non-inline fashion in Sphinx. It also makes use of
rst_epilog Sphinx conf for making this substitutions across all the
docs.

1 files changed, 8 insertions, 11 deletions

diff --git a/docs/faq/help.txt b/docs/faq/help.txt
index 287ca34657..cdc68d40bf 100644
--- a/docs/faq/help.txt
+++ b/docs/faq/help.txt
@@ -5,51 +5,48 @@ How do I do X? Why doesn't Y work? Where can I go to get help?
 --------------------------------------------------------------
 
 If this FAQ doesn't contain an answer to your question, you might want to
-try the `django-users mailing list`_. Feel free to ask any question related
+try the |django-users| mailing list. Feel free to ask any question related
 to installing, using, or debugging Django.
 
 If you prefer IRC, the `#django IRC channel`_ on the Freenode IRC network is an
 active community of helpful individuals who may be able to solve your problem.
 
-.. _`django-users mailing list`: http://groups.google.com/group/django-users
 .. _`#django IRC channel`: irc://irc.freenode.net/django
 
+.. _message-does-not-appear-on-django-users:
+
 Why hasn't my message appeared on django-users?
 -----------------------------------------------
 
-django-users_ has a lot of subscribers. This is good for the community, as
+|django-users| has a lot of subscribers. This is good for the community, as
 it means many people are available to contribute answers to questions.
-Unfortunately, it also means that django-users_ is an attractive target for
+Unfortunately, it also means that |django-users| is an attractive target for
 spammers.
 
-In order to combat the spam problem, when you join the django-users_ mailing
+In order to combat the spam problem, when you join the |django-users| mailing
 list, we manually moderate the first message you send to the list. This means
 that spammers get caught, but it also means that your first question to the
 list might take a little longer to get answered. We apologize for any
 inconvenience that this policy may cause.
 
-.. _django-users: http://groups.google.com/group/django-users
-
 Nobody on django-users answered my question! What should I do?
 --------------------------------------------------------------
 
 Try making your question more specific, or provide a better example of your
 problem.
 
-As with most open-source mailing lists, the folks on django-users_ are
+As with most open-source mailing lists, the folks on |django-users| are
 volunteers. If nobody has answered your question, it may be because nobody
 knows the answer, it may be because nobody can understand the question, or it
 may be that everybody that can help is busy. One thing you might try is to ask
 the question on IRC -- visit the `#django IRC channel`_ on the Freenode IRC
 network.
 
-You might notice we have a second mailing list, called django-developers_ --
+You might notice we have a second mailing list, called |django-developers| --
 but please don't email support questions to this mailing list. This list is
 for discussion of the development of Django itself. Asking a tech support
 question there is considered quite impolite.
 
-.. _django-developers: http://groups.google.com/group/django-developers
-
 I think I've found a bug! What should I do?
 -------------------------------------------