Create a Mailing List

Owned by Tracy Kuhrt
Last updated: Dec 15, 2020 by Ry Jones
2 min read

This HOWTO explains how you would create a new mailing list on the Hyperledger groups.io instance. This HOWTO is necessary for setting up new projects and new working groups.

Prerequisites

You must be an Owner on the Hyperledger mailing lists.

Step-by-step guide

  1. Browse to https://lists.hyperledger.org/g/main/subgroups
  2. Click the "Create Subgroup" button
    1. Provide the "Subgroup Email Address" of the mailing list. Do not include "hyperledger" here
    2. Provide a short description in the "Description" edit box that describes what this mailing list is for. Typical examples include:
    3. Check the "Visibility" settings. Most of our subgroups are set as "Subgroup listed in parent group, messages publicly viewable"
    4. Unclick the "Receive Updates" checkbox
  3. Click the "Create Subgroup" button to create the subgroup
  4. After the subgroup has been created, modify the details under "Admin | Settings"
    1. In the "Privacy" section, verify the following choices:

    2. In the "Spam Control" section, verify that none of the boxes have been selected
    3. In the "Message Policy" section, verify the following settings:
      1. "Allow Non Subscribers to Post" has been checked
      2. "Hashtag Permissions" is set to "Posts can be tagged with new hashtags"
      3. "Reply To" is set to "Group and Sender"
      4. All other boxes should be unchecked
      5. "Viruses" is set to "Block"
    4. In the "Message Formatting", set the "Subject Tag" so that it contains [Hyperledger <project name> or <group name>] (e.g., [Hyperledger Architecture WG])
    5. In the "Features" section, verify the following settings:
      1. "Calendar" is set to "Public and subscribers can view, moderators can edit"
      2. "Chats" is set to "Disabled"
      3. "Database" is set to "Disabled"
      4. "Files" is set to "Disabled"
      5. "Photos" is set to "Disabled"
      6. "Polls" is set to "Only moderators can create"
      7. "Wiki" is set to "Disabled"
  5. Click the "Update group" button

Add CA-Notices as Owner to get Calendaring to Work

We use the ca-notices@hyperledger.org account on groups.io to enable meeting management by the group moderators while also aggregating all group events into a single "Hyperledger Community Calendar". To do this, you must add ca-notices@hyperledger.org as the owner of the group, set the correct settings. Here's the steps to follow after creating the new subgroup:

  1. Navigate to the subgroup and click on "Admin" to expand the admin menu.
  2. Click on "Direct Add" and add the "ca-notices@hyperledger.org" account to the group.
  3. Click on "Members" and search for "ca-notices@hyperleger.org".
  4. Click on the member record to go to the member settings page.
    1. Change the "Role" to "Owner"
    2. Under "Notifications" set the following checkmarks:
      • Email when there are messages needing approval.
      • Email when there are members needing approval.
      • Email when a member joins/leaves this group.
      • Email when a group storage limits are reached.
      • Email when someone reports a message.
    3. Set "Owner Email" to "None"
    4. Set "Email Delivery" to "No Email"
    5. Set "Posting Privileges" to "Override: not allowed to post"
    6. Click "Save" to save the changes.