Skip to end of metadata
Go to start of metadata

 

SIGs have communication resources set up for their use.  This document describes how these resources are set up.  To have a SIG's resource set up, create a ticket on Issues in the FOLIO project.

SIGs have a full name and a brief "slug" (something short and memorable that will be used in various places).

Discuss.folio.org

Setting up a new Category on Discuss requires someone with the Admin privilege. (See Discuss about page for the list of current admins.) 

  1. At the homepage, select the hamburger menu at the upper right then "New Category"


  2. In the General tab of the New Category pane, put in the SIG name for Category Name and the SIG Slug for Category Slug.  Choose the appropriate parent category (most likely Special Interest Groups) and pick a background color to distinguish this SIG from others on Discuss.
  3. In the Settings tab of the New Category pane, check the box to Accept emails from anonymous users with no accounts.  For Custom incoming email address use: [sig-slug]@discuss.folio.org 

  4. Select New Category

  5. At the homepage, select the hamburger menu at the upper right then "Reorder Categories"

  6. The Category just created needs to be sorted alphabetically within the one or two levels of sorting.  Use the arrow keys to move the category up, or type a number in the text box and the checkmark to reorder the categories.  When ready, choose Fix Positions then Save Order.

  7. The Category just created will have one pinned topic with the headline "About the ... category".  View that topic, then activate the pencil icon to edit.  Delete all of the text in the box, then put in this structured text:
    email-address - wiki space link - description text.  For example:  i18n@discuss.folio.org - Wiki - The Internationalization SIG... Then Save Edit for this topic.

Wiki.folio.org

Setting up a new Space on Wiki requires someone with the Create-Space privilege.

  1. At the homepage, select Create Space near the upper right corner of the page.
  2. Choose Team Space
  3. In the Create Team Space pane, put the full name of the SIG for Space Name and the SIG Slug for Space Key. At this point, team members can also be created and the description added.
  4. From the Space Tools menu at the bottom right, select Permissions, then Edit Permissions.  Check the box for anonymous view all permissions, then Save all.
  5. Set up the Comments on Discuss macro. From the gear menu in the upper right of the page, select General Configuration then User macros
  6. Edit the Comments on Discuss macro. Scan down for the ## @param Category:title=Discuss comment, then add the SIG slug to the comma separated list of SIG slugs already there (in alphabetical order).  Activate Save.

Issues.folio.org

Setting up a new Tag on Issues does not require special permissions.

  1. In the Issue to create the SIG, activate the Labels field (under the Details section) and type the SIG slug with a "sig-" prefix.  For instance: sig-i18n  The UI will prompt to create the new tag.  Save the revised issue with the new tag.

FOLIO Slack

Setting up a slack channel does not require special permissions.

  1. Within Slack, activate the circle-plus icon next to Channels.  
  2. In the Create a channel pane, leave Public selected, use the SIG slug for the Name, and in the Purpose field put an abbreviated form of the SIG description.  Then activate Create Channel

 

  • No labels
Write a comment…