diff --git a/doc/source/lists.rst b/doc/source/lists.rst index 2597dc667c..08aedbd488 100644 --- a/doc/source/lists.rst +++ b/doc/source/lists.rst @@ -14,9 +14,11 @@ At a Glance :Hosts: * http://lists.openstack.org -:Puppet: - * https://opendev.org/opendev/puppet-mailman - * :git_file:`modules/openstack_project/manifests/lists.pp` +:Ansible: + * :git_file:`playbooks/service-lists.yaml` + * :git_file:`playbooks/roles/mailman` + * :git_file:`playbooks/roles/mailman-site` + * :git_file:`playbooks/roles/mailman-list` :Projects: * http://www.gnu.org/software/mailman/ :Bugs: @@ -29,18 +31,15 @@ Adding a List ============= A list may be added by adding it to the ``openstack-infra/system-config`` -repository in ``modules/openstack_project/manifests/lists.pp``. For -example: +repository in :git_file:`inventory/service/host_vars/lists.openstack.org.yaml`. +For example: -.. code-block:: ruby +.. code-block:: yaml - mailman_list { 'openstack-foo@openstack': - require => Mailman::Site['openstack'], - ensure => present, - admin => 'admin@example.com', - password => $listpassword, - description => 'Discussion of OpenStack Foo', - } + - name: Example list + description: 'This is an example' + admin: 'admin@example.com' + password: "{{ mailman_list_password }}" Scripted Changes to Lists ========================= diff --git a/modules/openstack_project/files/mailman/html-templates-en/admindbdetails.html b/modules/openstack_project/files/mailman/html-templates-en/admindbdetails.html deleted file mode 100644 index a6b7eb96d6..0000000000 --- a/modules/openstack_project/files/mailman/html-templates-en/admindbdetails.html +++ /dev/null @@ -1,60 +0,0 @@ -The administrative requests are displayed in one of two ways, on a summary page, and on a details page. -The summary page contains pending subscription and unsubscription -requests, as well as postings being held for your approval, grouped by -sender email address. The details page contains a more detailed view of -each held message, including the all the message's headers and an -excerpt of the message body. - -
On all the pages, the following actions are available: - -
For held messages, turn on the Preserve option if you want to -save a copy of the message for the site administrator. This is useful -for abusive messages that you want to discard, but need to keep a record -of for later inspection. - -
Turn on the Forward to option, and fill in the forwarding -address if you want to forward the message to someone else not on the -list. To edit a held message before it is sent on to the list, you -should forward the message to yourself (or the list owners), and discard -the original message. Then, when the message shows up in your mailbox, -make your edits and resend the message to the list, including an -Approved: header with the list password as its value. It is -proper netiquette in this case to include a note in the resent message, -explaining that you have modified the text. - -
If the sender is a list member who is being moderated, you can -optionally clear their moderation flag. This is useful when your list -is configured to put new members on probation, and you've decided that -this member can be trusted to post to the list without approval. - -
If the sender is not a list member, you can add the email address to -a sender filter. Sender filters are described on the sender filter privacy page, and may be one of -auto-accept (Accepts), auto-hold (Holds), -auto-reject (Rejects), or auto-discard (Discards). This -option will not be available if the address is already on one of the -sender filters. - -
When you're finished, click on the Submit All Data button at -the top or bottom of the page. This button will submit all selected -actions for all administrative requests that you've made a decision for. - -
Return to the summary page. diff --git a/modules/openstack_project/files/mailman/html-templates-en/admindbpreamble.html b/modules/openstack_project/files/mailman/html-templates-en/admindbpreamble.html deleted file mode 100644 index 659b77e729..0000000000 --- a/modules/openstack_project/files/mailman/html-templates-en/admindbpreamble.html +++ /dev/null @@ -1,10 +0,0 @@ -This page contains a subset of the %(listname)s mailing list -postings that are being held for your approval. It currently shows -%(description)s - -
For each administrative request, please select the action to take, -clicking on the Submit All Data when finished. More detailed -instructions are available here. - -
You can also view a summary of all -pending requests. diff --git a/modules/openstack_project/files/mailman/html-templates-en/admindbsummary.html b/modules/openstack_project/files/mailman/html-templates-en/admindbsummary.html deleted file mode 100644 index 20ffef5846..0000000000 --- a/modules/openstack_project/files/mailman/html-templates-en/admindbsummary.html +++ /dev/null @@ -1,14 +0,0 @@ -This page contains a summary of the current set of administrative -requests requiring your approval for the -%(listname)s mailing list. -First, you will find the list of pending -subscription and unsubscription requests, if any, followed by any -postings being held for your approval. - -
For each administrative request, please select the action to take, -clicking on the Submit All Data button when finished. -More detailed instructions are also -available. - -
You can also view the details of all -held postings. diff --git a/modules/openstack_project/files/mailman/html-templates-en/adminsubscribeack.txt b/modules/openstack_project/files/mailman/html-templates-en/adminsubscribeack.txt deleted file mode 100644 index 388a3a2401..0000000000 --- a/modules/openstack_project/files/mailman/html-templates-en/adminsubscribeack.txt +++ /dev/null @@ -1,3 +0,0 @@ -%(member)s has been successfully subscribed to %(listname)s. - - diff --git a/modules/openstack_project/files/mailman/html-templates-en/adminunsubscribeack.txt b/modules/openstack_project/files/mailman/html-templates-en/adminunsubscribeack.txt deleted file mode 100644 index 2ebcfeb707..0000000000 --- a/modules/openstack_project/files/mailman/html-templates-en/adminunsubscribeack.txt +++ /dev/null @@ -1,2 +0,0 @@ -%(member)s has been removed from %(listname)s. - diff --git a/modules/openstack_project/files/mailman/html-templates-en/admlogin.html b/modules/openstack_project/files/mailman/html-templates-en/admlogin.html deleted file mode 100644 index 4dd2574c27..0000000000 --- a/modules/openstack_project/files/mailman/html-templates-en/admlogin.html +++ /dev/null @@ -1,40 +0,0 @@ - -
-
- Last message date:
- %(lastdate)s
- Archived on: %(archivedate)s
-
-