Improve page organization (closes #754)

- Eliminate excessive bullet points and subheadings
- Deduplicate Gmane information
- Make heading syntax consistent
- Clarify instructions
This commit is contained in:
Andrew David Wong 2018-12-05 22:00:22 -06:00
parent 9586996f15
commit fcbd1843e4
No known key found for this signature in database
GPG Key ID: 8CE137352A019A17

View File

@ -13,16 +13,14 @@ redirect_from:
- /wiki/QubesLists/ - /wiki/QubesLists/
--- ---
Help, Support, and Mailing Lists # Help, Support, and Mailing Lists #
================================
Help and support for Qubes OS is available from the [documentation] and the Help and support for Qubes OS is available from the [documentation] and the
[mailing lists], which are explained below. The Qubes OS Project does not offer [mailing lists], which are explained below. The Qubes OS Project does not offer
paid support services. paid support services.
Staying safe ## Staying safe ##
------------
The Qubes mailing lists are open to the public. The contents of the list are The Qubes mailing lists are open to the public. The contents of the list are
crawled by search engines and archived by third-party services outside of our crawled by search engines and archived by third-party services outside of our
@ -58,8 +56,7 @@ cryptographically signed, anyone would be in a position to [verify] that these
came from the same keyholder. came from the same keyholder.
Discussion list guidelines ## Discussion list guidelines ##
--------------------------
Qubes discussions mainly take place on two mailing lists: `qubes-users` and Qubes discussions mainly take place on two mailing lists: `qubes-users` and
`qubes-devel`, both of which are explained below. Please send all questions `qubes-devel`, both of which are explained below. Please send all questions
@ -141,6 +138,7 @@ guidelines.
don't simply point it out in an email to one of the mailing lists. Instead, don't simply point it out in an email to one of the mailing lists. Instead,
[submit the change][contributing to the documentation]. [submit the change][contributing to the documentation].
### Specific rules and notes ### ### Specific rules and notes ###
#### Use the correct list #### #### Use the correct list ####
@ -219,36 +217,43 @@ guidelines.
free infrastructure, and we [distrust the infrastructure]. This is why, for free infrastructure, and we [distrust the infrastructure]. This is why, for
example, we encourage discussants to use [Split GPG] to sign all of their example, we encourage discussants to use [Split GPG] to sign all of their
messages to the lists, but we do not endorse the use of these Google Groups messages to the lists, but we do not endorse the use of these Google Groups
as web forums. (There have been many discussions about why the Qubes OS as web forums. Some users prefer to interact with the mailing lists through
Project does not maintain a forum. The curious can find these by searching their optional web interfaces. This has the advantage that it allows you to
search and reply to messages which were sent prior to your subscription to
the list. However, a Google account is required in order to post through the
web interfaces. (Note: There have been many discussions about why the Qubes
OS Project does not maintain a forum. The curious can find these by searching
the list archives.) the list archives.)
#### Gmane ####
qubes-announce Qubes mailing lists are also available via Gmane, a service that provides mailing lists in the form of newsgroups.
-------------- This makes it possible for you to subscribe and read all mails sent to the list without having them all sent to your normal mail account.
To use Gmane, you need a newsreader such as [Thunderbird].
To add Gmane's server to Thunderbird, follow the instructions in [Mozilla Thunderbird's documentation for how to add newsgroups][thunderbird-newsgroup].
In the fourth step replace `news.mozilla.org` with `news.gmane.org`.
To subscribe to a list, click **Subscribe...** and search for the newsgroup `gmane.os.qubes.<list>`, for example, [`gmane.os.qubes.user`].
Check the box beside the name and click **OK**.
You can now send and reply to mails the same way you would normally.
To unsubscribe from the list, click **Subscribe...** and search for the newsgroup `gmane.os.qubes.<list>`, for example, [`gmane.os.qubes.user`].
Uncheck the box beside the name and click **OK**.
Thunderbird will automatically remove the newsgroup.
## qubes-announce ##
This is a read-only list for those who wish to receive only very important, This is a read-only list for those who wish to receive only very important,
infrequent messages. Only the core Qubes team can post to this list, and only infrequent messages. Only the core Qubes team can post to this list, and only
[Qubes Security Bulletins (QSBs)][qsb] and new Qubes OS releases are announced [Qubes Security Bulletins (QSBs)][qsb] and new Qubes OS releases are announced
here. here.
### How to subscribe To subscribe, send a blank email to `qubes-announce+subscribe@googlegroups.com`.
(Note: A Google account is *not* required. Any email address will work.)
#### Google Groups To unsubscribe, send a blank email to `qubes-announce+unsubscribe@googlegroups.com`.
This list also has an optional [Google Groups web interface][qubes-announce-web].
* To subscribe to the list, send a blank email to
`qubes-announce+subscribe@googlegroups.com`.
* Note: A Gmail account is *not* required. Any email address will work.
* To unsubscribe, send a blank email to
`qubes-announce+unsubscribe@googlegroups.com`.
* This list can also be browsed via an optional [Google Groups web
interface][qubes-announce-web].
qubes-users ## qubes-users ##
-----------
### How to use this list
This list is for helping users solve various daily problems with Qubes OS. This list is for helping users solve various daily problems with Qubes OS.
Examples of topics or questions suitable for this list include: Examples of topics or questions suitable for this list include:
@ -258,8 +263,6 @@ Examples of topics or questions suitable for this list include:
* Hardware compatibility problems * Hardware compatibility problems
* Questions of the form: "How do I...?" * Questions of the form: "How do I...?"
### Read these first
Please try searching both the Qubes website and the archives of the mailing Please try searching both the Qubes website and the archives of the mailing
lists before sending a question. In addition, please make sure that you have lists before sending a question. In addition, please make sure that you have
read and understood the following basic documentation prior to posting to the read and understood the following basic documentation prior to posting to the
@ -270,55 +273,17 @@ list:
* The [User FAQ] * The [User FAQ]
* The [documentation] (for questions about how to use Qubes OS) * The [documentation] (for questions about how to use Qubes OS)
### How to subscribe and post You don't have to subscribe in order to post to this list.
However, subscribing makes your messages less likely to be marked as spam and allows you to receive messages sent directly to the list.
#### Google Groups To subscribe to the list, send a blank email to `qubes-users+subscribe@googlegroups.com`.
(Note: A Google account is *not* required. Any email address will work.)
You don't have to subscribe in order to post to this list. However, subscribing To post a message to the list, address your email to `qubes-users@googlegroups.com`.
might nonetheless be desirable, as it ensures that your messages will not be If your post does not appear immediately, please allow time for moderation to occur.
eaten by the Google Groups spam filter and allows you to receive messages which To unsubscribe, send a blank email to `qubes-users+unsubscribe@googlegroups.com`.
were sent directly to the list. This list also has an optional [Google Groups web interface][qubes-users-web] and [traditional mail archive][qubes-users-archive].
* To subscribe to the list, send a blank email to
`qubes-users+subscribe@googlegroups.com`.
* Note: A Gmail account is *not* required. Any email address will work.
* To post a message to the list, address your email to
`qubes-users@googlegroups.com`.
* Note: You don't have to be subscribed in order to post.
* To unsubscribe, send a blank email to
`qubes-users+unsubscribe@googlegroups.com`.
* This list also has a [Google Groups web interface][qubes-users-web].
* Some users prefer to interact with the mailing list through the web
interface. This has the advantage that it allows you to search and reply to
messages which were sent prior to your subscription to the list. However, a
Google account is required in order to post through this interface.
* You can also search the [traditional mail archive][qubes-users-archive]
#### Gmane
The mailing list is also available via Gmane, a service that provides mailing
lists in the form of newsgroups. This makes it possible for you to subscribe
and read all mails sent to the list without having them all sent to your normal
mail account. To use Gmane, you need a newsreader such as [Thunderbird].
To add Gmane's server to Thunderbird, follow the instructions in
[Mozilla Thunderbird's documentation for how to add
newsgroups][thunderbird-newsgroup].
In the fourth step replace `news.mozilla.org` with `news.gmane.org`.
* To subscribe to the list, click on **Subscribe...** and search for the
newsgroup [`gmane.os.qubes.user`]. Click on the checkbox besides the name
and **OK**.
* You send and reply to mails the same way you would normally.
* To unsubscribe from the list, click on **Subscribe...**
search for the newsgroup [`gmane.os.qubes.user`], uncheck the checkbox, and
click on **OK**. Thunderbird will automatically remove the newsgroup.
qubes-devel ## qubes-devel ##
-----------
### How to use this list
This list is primarily intended for people who are interested in contributing to This list is primarily intended for people who are interested in contributing to
Qubes or who are willing to learn more about its architecture and Qubes or who are willing to learn more about its architecture and
@ -332,53 +297,16 @@ implementation. Examples of topics and questions suitable for this list include:
* Contributed code and patches. * Contributed code and patches.
* Security discussions which are relevant to Qubes in some way. * Security discussions which are relevant to Qubes in some way.
### How to subscribe and post
#### Google Groups
You must be subscribed in order to post to this list. You must be subscribed in order to post to this list.
To subscribe, send a blank email to `qubes-devel+subscribe@googlegroups.com`.
* To subscribe to the list, send a blank email to (Note: A Google account is *not* required. Any email address will work.)
`qubes-devel+subscribe@googlegroups.com`. To post a message to the list, address your email to `qubes-devel@googlegroups.com`.
* Note: A Gmail account is *not* required. Any email address will work. If your post does not appear immediately, please allow time for moderation to occur.
* To post a message to the list, address your email to To unsubscribe, send a blank email to `qubes-devel+unsubscribe@googlegroups.com`.
`qubes-devel@googlegroups.com`. This list also has an optional [Google Groups web interface][qubes-devel-web] and [traditional mail archive][qubes-devel-archive].
* Note: You must be subscribed in order to post. If your post does not
appear, please allow time for moderation to occur.
* To unsubscribe, send a blank email to
`qubes-devel+unsubscribe@googlegroups.com`.
* This list has a [Google Groups web interface][qubes-devel-web].
* Some users prefer to interact with the mailing list through the web
interface. This has the advantage that it allows you to search and reply to
messages which were sent prior to your subscription to the list. However, a
Google account is required in order to post through this interface.
* You can also search the [traditional mail archive][qubes-devel-archive]
#### Gmane
The mailing list is also available via Gmane, a service that provides mailing
lists in the form of newsgroups. This makes it possible for you to subscribe
and read all mails sent to the list without having them all sent to your normal
mail account. To use Gmane, you need a newsreader such as [Thunderbird].
To add Gmane's server to Thunderbird, follow the instructions in
[Mozilla Thunderbird's documentation for how to add
newsgroups][thunderbird-newsgroup].
In the fourth step replace `news.mozilla.org` with `news.gmane.org`.
* To subscribe to the list, click on **Subscribe...** and search for the
newsgroup [`gmane.os.qubes.devel`]. Click on the checkbox besides the name
and **OK**.
* You send and reply to mails the same way you would normally.
* To unsubscribe from the list, click on **Subscribe...**
search for the newsgroup [`gmane.os.qubes.devel`], uncheck the checkbox, and
click on **OK**. Thunderbird will automatically remove the newsgroup.
qubes-project ## qubes-project ##
-------------
### How to use this list
This list is for non-technical discussion and coordination around the This list is for non-technical discussion and coordination around the
Qubes OS project. Qubes OS project.
@ -390,54 +318,17 @@ Examples of topics or question suitable for this list include:
* FOSS governance discussions * FOSS governance discussions
* Most Github issues tagged "[business]" * Most Github issues tagged "[business]"
### How to subscribe and post You don't have to subscribe in order to post to this list.
However, subscribing makes your messages less likely to be marked as spam and allows you to receive messages sent directly to the list.
#### Google Groups To subscribe, send a blank email to `qubes-project+subscribe@googlegroups.com`.
(Note: A Google account is *not* required. Any email address will work.)
You don't have to subscribe in order to post to this list. However, subscribing To post a message to the list, address your email to `qubes-project@googlegroups.com`.
might nonetheless be desirable, as it ensures that your messages will not be If your post does not appear immediately, please allow time for moderation to occur.
eaten by the Google Groups spam filter and allows you to receive messages which To unsubscribe, send a blank email to `qubes-project+unsubscribe@googlegroups.com`.
were sent directly to the list. This list also also has an optional [Google Groups web interface][qubes-project-web].
* To subscribe to the list, send a blank email to
`qubes-project+subscribe@googlegroups.com`.
* Note: A Gmail account is *not* required. Any email address will work.
* To post a message to the list, address your email to
`qubes-project@googlegroups.com`.
* Note: You don't have to be subscribed in order to post.
* To unsubscribe, send a blank email to
`qubes-project+unsubscribe@googlegroups.com`.
* This list also has a [Google Groups web interface][qubes-project-web].
* Some users prefer to interact with the mailing list through the web
interface. This has the advantage that it allows you to search and reply to
messages which were sent prior to your subscription to the list. However, a
Google account is required in order to post through this interface.
#### Gmane
The mailing list is also available via Gmane, a service that provides mailing
lists in the form of newsgroups. This makes it possible for you to subscribe
and read all mails sent to the list without having them all sent to your normal
mail account. To use Gmane, you need a newsreader such as [Thunderbird].
To add Gmane's server to Thunderbird, follow the instructions in
[Mozilla Thunderbird's documentation for how to add
newsgroups][thunderbird-newsgroup].
In the fourth step replace `news.mozilla.org` with `news.gmane.org`.
* To subscribe to the list, click on **Subscribe...** and search for the
newsgroup [`gmane.os.qubes.project`]. Click on the checkbox besides the name
and **OK**.
* You send and reply to mails the same way you would normally.
* To unsubscribe from the list, click on **Subscribe...**
search for the newsgroup [`gmane.os.qubes.project`], uncheck the checkbox, and
click on **OK**. Thunderbird will automatically remove the newsgroup.
qubes-translation ## qubes-translation ##
-----------------
### How to use this list
This list is for discussion around the localization and translation of Qubes OS, This list is for discussion around the localization and translation of Qubes OS,
its documentation, and the website. its documentation, and the website.
@ -448,25 +339,14 @@ Examples of topics or question suitable for this list include:
* Who is managing localization for a given language * Who is managing localization for a given language
* Most Github issues tagged "[localization]" * Most Github issues tagged "[localization]"
### How to subscribe and post You don't have to subscribe in order to post to this list.
However, subscribing makes your messages less likely to be marked as spam and allows you to receive messages sent directly to the list.
#### Google Groups To subscribe, send a blank email to `qubes-translation+subscribe@googlegroups.com`.
(Note: A Google account is *not* required. Any email address will work.)
You must be subscribed in order to post to this list. To post a message to the list, address your email to `qubes-translation@googlegroups.com`.
If your post does not appear immediately, please allow time for moderation to occur.
* To subscribe to the list, send a blank email to To unsubscribe, send a blank email to `qubes-translation+unsubscribe@googlegroups.com`.
`qubes-translation+subscribe@googlegroups.com`. This list also has an optional [Google Groups web interface][qubes-translation-web].
* Note: A Gmail account is *not* required. Any email address will work.
* To post a message to the list, address your email to
`qubes-translation@googlegroups.com`.
* Note: You don't have to be subscribed in order to post.
* To unsubscribe, send a blank email to
`qubes-translation+unsubscribe@googlegroups.com`.
* This list also has a [Google Groups web interface][qubes-translation-web].
* Some users prefer to interact with the mailing list through the web
interface. This has the advantage that it allows you to search and reply to
messages which were sent prior to your subscription to the list. However, a
Google account is required in order to post through this interface.
[mailing lists]: https://en.wikipedia.org/wiki/Electronic_mailing_list [mailing lists]: https://en.wikipedia.org/wiki/Electronic_mailing_list