git: 035828ef9c - main - Mailing lists: correctness, conciseness

From: Graham Perrin <grahamperrin_at_FreeBSD.org>
Date: Thu, 13 Jul 2023 07:03:13 UTC
The branch main has been updated by grahamperrin:

URL: https://cgit.FreeBSD.org/doc/commit/?id=035828ef9c0dc2fdd8f8264175307b688b235f86

commit 035828ef9c0dc2fdd8f8264175307b688b235f86
Author:     Graham Perrin <grahamperrin@FreeBSD.org>
AuthorDate: 2023-07-13 06:57:51 +0000
Commit:     Graham Perrin <grahamperrin@FreeBSD.org>
CommitDate: 2023-07-13 06:57:51 +0000

    Mailing lists: correctness, conciseness
    
    Do not begin with misdirection to the FreeBSD Handbook.
    
    Raise awareness of answers to lists-specific FAQ.
    
    Add the FreeBSD-provided search engine, mention MarkMail and
    DuckDuckGo.
    
    Be concise: minimise repetition, and so on.
---
 website/content/en/community/mailinglists.adoc | 25 +++++++++++++++++++------
 1 file changed, 19 insertions(+), 6 deletions(-)

diff --git a/website/content/en/community/mailinglists.adoc b/website/content/en/community/mailinglists.adoc
index 5fb4746874..7ec6feed95 100644
--- a/website/content/en/community/mailinglists.adoc
+++ b/website/content/en/community/mailinglists.adoc
@@ -3,19 +3,32 @@ title: "Mailing Lists"
 sidenav: community
 ---
 
+include::shared/en/mailing-lists.adoc[]
 include::shared/en/urls.adoc[]
 
 = Mailing Lists
 
-Mailing lists are the primary communication channels for the FreeBSD community, and cover many topic areas. They are generally English language unless otherwise stated; a list is given link:{handbook}eresources/#eresources-mail[in the FreeBSD Handbook].
+Mailing lists are the primary communication channel for the FreeBSD community, and cover many topic areas:
 
-== Mailing list archives
+- https://lists.freebsd.org/[]
+- link:{mailing-list-faq}[frequently asked questions about the lists].
 
-You can link:../../search/#mailinglists[search] or https://lists.FreeBSD.org/archives/[browse] the mailing list archives. At the current time, archives prior to May 2021 are in https://lists.freebsd.org/pipermail/[a separate archive].
+Lists are English language, unless stated otherwise.
 
-== Non-English Mailing lists
+== Archives
 
-Several non-English mailing lists are also available:
+Browse:
+
+- https://lists.FreeBSD.org/archives/[]
+
+Search:
+
+- https://lists.freebsd.org/search[]
+- link:../../search/#mailinglists[MarkMail, DuckDuckGo ...]
+
+Achives prior to May 2021 are in https://lists.freebsd.org/pipermail/[a separate area].
+
+== Non-English Lists
 
 * *Brazilian Portuguese* -- freebsd-subscribe@fug.com.br or http://www.fug.com.br/[WWW].
 * *Czech* -- users-l-request@FreeBSD.cz or http://www.cz.FreeBSD.org/listserv/listinfo/users-l/[WWW].
@@ -27,4 +40,4 @@ Several non-English mailing lists are also available:
 * *Russian* -- https://groups.google.com/forum/#!forum/uafug[UAFUG].
 * *Swedish* -- bus@stacken.kth.se or https://lists.stacken.kth.se/mailman/listinfo/bus[WWW].
 
-If you create other FreeBSD mailing lists, please link:../../mailto/[let us know about them].
+If you create another list, please link:../../mailto/[let us know].