From f35d556a3f324551fa35e102481bb138dcc1292d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Juge?= <gregoire.juge@gmail.com>
Date: Fri, 9 Sep 2022 15:29:26 +0200
Subject: [PATCH 1/3]  #11652 Migrate Twisted Community page to RST

- also add Community page to index
---
 docs/community.rst | 39 +++++++++++++++++++++++++++++++++++++++
 docs/index.rst     |  3 ++-
 2 files changed, 41 insertions(+), 1 deletion(-)
 create mode 100644 docs/community.rst

diff --git a/docs/community.rst b/docs/community.rst
new file mode 100644
index 00000000000..ed4278b7cf4
--- /dev/null
+++ b/docs/community.rst
@@ -0,0 +1,39 @@
+Twisted Community
+#################
+
+For interacting with the twisted community members, you have several options:
+
+Mail Lists
+==========
+
+If you want to participate in Twisted's community or development, you probably want to join the main mailing list:
+
+- `twisted-python <https://mail.python.org/mailman3/lists/twisted.python.org/>`_ - the main Twisted discussion list
+
+You can subscribe to the mailing list using the web interface linked above.
+
+ML Archives:
+
+- `Current list archive <https://mail.python.org/archives/list/twisted@python.org/>`_
+- `Other archives <https://github.com/twisted/pipermail>`_
+
+Stack Overflow
+==============
+
+Stack Overflow is a programming Q & A site.  You can find Twisted-related questions there, often with answers:
+
+- https://stackoverflow.com/questions/tagged/twisted
+
+Real-Time Chat
+==============
+
+Server: ``irc.libera.chat`` (more about `the Libera IRC network <https://libera.chat>`_)
+
+For support, you can join this channel:
+
+- `#twisted <irc://irc.libera.chat/twisted>`_  - support for Twisted and its ecosystem
+
+Blogs
+=====
+
+Read `Planet Twisted <https://planet.twistedmatrix.com/>`_.
diff --git a/docs/index.rst b/docs/index.rst
index 17e6599f5b2..715984f11a3 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -28,6 +28,7 @@ Contents:
    :caption: Quick links
 
    security
+   community
    api/index
    GitHub <https://github.com/twisted/twisted>
-   PyPI <https://pypi.org/project/twisted>
\ No newline at end of file
+   PyPI <https://pypi.org/project/twisted>

From b1ad03a47a4d53ebca946f6f1b61931410a3b5ef Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Juge?= <gregoire.juge@gmail.com>
Date: Fri, 9 Sep 2022 15:37:16 +0200
Subject: [PATCH 2/3]  #11652 Add misc newsfragments

---
 src/twisted/newsfragments/11652.misc | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 src/twisted/newsfragments/11652.misc

diff --git a/src/twisted/newsfragments/11652.misc b/src/twisted/newsfragments/11652.misc
new file mode 100644
index 00000000000..e69de29bb2d

From b59d7f1e3098374f13c7ab7d0c6194954f480b63 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Juge?= <gregoire.juge@gmail.com>
Date: Fri, 9 Sep 2022 21:05:09 +0200
Subject: [PATCH 3/3]  #11652 Mention the Twisted Gitter channel

---
 docs/community.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/docs/community.rst b/docs/community.rst
index ed4278b7cf4..e793135b1a1 100644
--- a/docs/community.rst
+++ b/docs/community.rst
@@ -27,9 +27,12 @@ Stack Overflow is a programming Q & A site.  You can find Twisted-related questi
 Real-Time Chat
 ==============
 
-Server: ``irc.libera.chat`` (more about `the Libera IRC network <https://libera.chat>`_)
+You can join the `Twisted Gitter channel <https://gitter.im/twisted/twisted>`_ (or simply click the "Open Chat" button at the bottom-right of this screen).
+Gitter is based on `Matrix <https://matrix.org/>`_, which is itself built with Twisted !
+
+Alternatively you can join the following IRC channel. There are gateways between the Gitter and IRC channels.
 
-For support, you can join this channel:
+Server: ``irc.libera.chat`` (more about `the Libera IRC network <https://libera.chat>`_)
 
 - `#twisted <irc://irc.libera.chat/twisted>`_  - support for Twisted and its ecosystem