Overview of team tags and team groups in the Edgeryders forum

Hello Nic, I assume you are talking about this forum and not Nextcloud. Since I find this discussion informative and not needing to be kept private, I am taking the liberty of transforming it into a public IT topic.

Tags vs. groups

In Discourse, tags are keywords attached to topics. They are prefixed by the # sign, for example reef-it . You add them to topics to make them more findable. In The Reef, we have a convention that teams assign a tag of the form reef-TEAMNAME to discussions that members of that team should be aware of. TEAMNAME is a single word: for example reef-finance, not reef-finance-and-legals.

Groups are “boxes” to which you can assign users. They are prefixed by the @ sign, for example @reef-it. You use them to send notifications (in a normal topic) or messages to the users in the group, without having to remembers the names of all group members. In The Reef, we have the convention that teams associate all their members to a group called reef-TEAMNAME, again with TEAMNAME a single word.

To find all groups, click on the hamburger menu next to your avatar and select Groups (direct link). You will find all groups used in Edgeryders, not just those of The Reef. To select the latter, type “reef” into the search box top right.

Adding tags is possible for any logged in user (see below). To add groups you need to have content manager powers. If you want to add a group, let me know and I will give you the necessary access, or just let me or @manuelpueyo know what you want and we will do it for you.

Introduction to tags in The Reef

  • We started using tags them as a way to easily access the growing body of work of teams.
  • We prefix with reef- because we are hosted by the Edgeryders forum, whose users are, for the most part, not involved in The Reef, and we do not want to disturb their work, nor for our own workspace to be cluttered by theirs. For example, the tag finance existed before we started. So, we are calling our own tag reef-finance instead.
  • To assign a tag to a topic, simply type the tag in the rightmost box under the title of the topic (the leftmost one contains the category, or subforum). If you have editing rights on a topic (for example because you are its author) you can also assign tags after you have created it.

  • You can assign more than one tag to the same topic. And you should, for example when a discussion concerns more than one team.
  • Creating a new topic works the same way as assigning an existing one. For example, if you type reef-kitchen into the tags box and there is no such tag, Discourse creates one and assigns it to your topic.

Finding Reef-related tags

The best way find tags is via the Tags view.

  1. Click on the hamburger menu next to your avatar, then select Tags
  2. At the top of the tag page, select Sort by name by clicking on the word “name”. This gives you an alphabetically ordered list of all tags used in Edgeryders. Scroll to the list of tags begining in reef-.
1 Like