From Fedora Project Wiki

(add alternatives to topics)
 
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{admon/important|NOTE|This is just a draft right now, please don't treat anything on it as finished or complete}}
== Introduction ==
 
= Introduction =


Currently most mailing lists managed by the Fedora project are using the standard and venerable mailman2 software. Recently the mailman project has (finally!) released the long under development next generation version of mailman, mailman3. The Fedora project is going to move all its mailing list instances to this new and improved version. This page contains background and things you may need to know or adjust about the new mailman3 setup.
Currently most mailing lists managed by the Fedora project are using the standard and venerable mailman2 software. Recently the mailman project has (finally!) released the long under development next generation version of mailman, mailman3. The Fedora project is going to move all its mailing list instances to this new and improved version. This page contains background and things you may need to know or adjust about the new mailman3 setup.


= What are all these parts? =
=== What are all these parts? ===


Mailman3 is built in a modular way with several subprojects providing smaller parts of the entire setup.  
Mailman3 is built in a modular way with several subprojects providing smaller parts of the entire setup.  
Line 13: Line 11:
* Postorius - The admin interface/application. This is where you login and change your list options or subscriptions or moderate or manage lists if you have been given that power.  
* Postorius - The admin interface/application. This is where you login and change your list options or subscriptions or moderate or manage lists if you have been given that power.  


* Hyperkitty - The archiver/web interface. Hyperkitty is not only a archive of posts, but also allows you to post from the web, rate posts any many other features.  
* Hyperkitty - The archiver/web interface. Hyperkitty is not only a archive of posts, but also allows you to post from the web, rate posts and many other features.
 
=== Per list migration process ===
 
List migrations are being done in small batches to avoid any kind of large outage in lists. Email to lists is sent to the mailman2 or mailman3 backend depending on if the list has been migrated yet or not. Similarly archives and web pages direct you to the right place for the list you are interested in. Please let us know if you find any broken links or are redirected to an incorrect location for a list.
 
Fedora lists will be migrated in mass during the week starting on the 2015-11-16. The migration will start with the fedorahosted.org lists, the fedoraproject.org lists will follow.
 
The status of the migration can be tracked on the [[Mailman3_Migration/Status]] page.


= Logins and passwords =


The old mailman setup used per list or per site passwords for users to login and manage settings. Mailman3 has actual logins using Fedora's persona/openid server. No passwords are needed/sent to users in the clear monthly or otherwise. You can login and manage your settings right away.
== Changes ==


= Per-topic subscriptions are gone (affects the package update announcement mailing list) =
=== Email filters ===


Mailman has the ability to categorize posts by topic. We don't use this heavily, but it ''is'' used to categorize posts to the [https://lists.fedoraproject.org/mailman/listinfo/package-announce package-announce list]. They're seperated by Fedora version, and security fixes are tagged as such.
The <code>X-BeenThere</code> header has been deprecated since 2007 and Mailman3 will not add it to the outbound emails anymore. If you used this header for your filters, you must switch to the <code>List-Id</code> header (or <code>List-Post</code> header).


With the older mailman, one could elect to only receive mail for specific topic. The new mailman3 retains the topics, but can't currently only deliver certain topics. Instead, we recommend filtering in your mail client.
=== Logins and passwords ===


TODO: example filters for procmail, thunderbird, gmail
The old mailman setup used per list or per site passwords for users to login and manage settings. Mailman3 has actual logins using Fedora's persona/openid server. No passwords are needed/sent to users in the clear monthly or otherwise. You can login and manage your settings right away.
 
=== Per-topic subscriptions are gone (affects the package update announcement mailing list) ===


= Links =
Mailman has the ability to categorize posts by topic. We don't use this heavily, but it ''is'' used to categorize posts to the [https://lists.fedoraproject.org/mailman/listinfo/package-announce package-announce list]. They're separated by Fedora version, and security fixes are tagged as such.


TODO: add links to old new
With the older mailman, one could elect to only receive mail for specific topic. The new mailman3 retains the topics, but can't currently only deliver certain topics. Instead, we recommend filtering in your mail client or using Fedora messages ( https://apps.fedoraproject.org/notifications ) or bodhi rss feeds ( for example: https://bodhi.fedoraproject.org/rss/updates/?releases=F23&type=newpackage ).


TODO: add more items people might notice.
TODO: example filters for procmail, thunderbird, gmail


= Reporting problems or issues =
== Reporting problems or issues ==


If you find a problem or issue, please file a fedora infrastructure ticket and we will work to fix things for your case or bug.
If you find a problem or issue, please file a [https://fedorahosted.org/fedora-infrastructure/ fedora infrastructure ticket] and we will work to fix things for your case or bug.

Latest revision as of 23:19, 18 April 2016

Introduction

Currently most mailing lists managed by the Fedora project are using the standard and venerable mailman2 software. Recently the mailman project has (finally!) released the long under development next generation version of mailman, mailman3. The Fedora project is going to move all its mailing list instances to this new and improved version. This page contains background and things you may need to know or adjust about the new mailman3 setup.

What are all these parts?

Mailman3 is built in a modular way with several subprojects providing smaller parts of the entire setup.

  • mailman - The entire project
  • Postorius - The admin interface/application. This is where you login and change your list options or subscriptions or moderate or manage lists if you have been given that power.
  • Hyperkitty - The archiver/web interface. Hyperkitty is not only a archive of posts, but also allows you to post from the web, rate posts and many other features.

Per list migration process

List migrations are being done in small batches to avoid any kind of large outage in lists. Email to lists is sent to the mailman2 or mailman3 backend depending on if the list has been migrated yet or not. Similarly archives and web pages direct you to the right place for the list you are interested in. Please let us know if you find any broken links or are redirected to an incorrect location for a list.

Fedora lists will be migrated in mass during the week starting on the 2015-11-16. The migration will start with the fedorahosted.org lists, the fedoraproject.org lists will follow.

The status of the migration can be tracked on the Mailman3_Migration/Status page.


Changes

Email filters

The X-BeenThere header has been deprecated since 2007 and Mailman3 will not add it to the outbound emails anymore. If you used this header for your filters, you must switch to the List-Id header (or List-Post header).

Logins and passwords

The old mailman setup used per list or per site passwords for users to login and manage settings. Mailman3 has actual logins using Fedora's persona/openid server. No passwords are needed/sent to users in the clear monthly or otherwise. You can login and manage your settings right away.

Per-topic subscriptions are gone (affects the package update announcement mailing list)

Mailman has the ability to categorize posts by topic. We don't use this heavily, but it is used to categorize posts to the package-announce list. They're separated by Fedora version, and security fixes are tagged as such.

With the older mailman, one could elect to only receive mail for specific topic. The new mailman3 retains the topics, but can't currently only deliver certain topics. Instead, we recommend filtering in your mail client or using Fedora messages ( https://apps.fedoraproject.org/notifications ) or bodhi rss feeds ( for example: https://bodhi.fedoraproject.org/rss/updates/?releases=F23&type=newpackage ).

TODO: example filters for procmail, thunderbird, gmail

Reporting problems or issues

If you find a problem or issue, please file a fedora infrastructure ticket and we will work to fix things for your case or bug.