From af7c3cc25f7b90e535c2a5301567ded796730031 Mon Sep 17 00:00:00 2001
From: Frank Mueller <mue@tideland.biz>
Date: Tue, 5 Dec 2017 16:38:58 +0100
Subject: [PATCH] Extended glossary and added user story 2

---
 active/39-chat-moderation/glossary.md         |  9 +++--
 active/39-chat-moderation/roles.md            | 12 +++---
 .../user-stories/us-1-blocking-a-user.md      |  2 +-
 .../user-stories/us-2-reducing-spam.md        | 40 +++++++++++++++++++
 4 files changed, 53 insertions(+), 10 deletions(-)
 create mode 100644 active/39-chat-moderation/user-stories/us-2-reducing-spam.md

diff --git a/active/39-chat-moderation/glossary.md b/active/39-chat-moderation/glossary.md
index d8e54d9..2c5ae52 100644
--- a/active/39-chat-moderation/glossary.md
+++ b/active/39-chat-moderation/glossary.md
@@ -1,5 +1,8 @@
 # Glossary
 
-| Term               | Meaning                                          |
-|--------------------|--------------------------------------------------|
-| Chat               | Textual communication between two or more users. |
+| Term | Meaning |
+| ---- | ------- |
+| Chat | Textual communication between two users. |
+| Chat Room | Grouping of users chatting about a topic or having any other kind of relation. Opposite to bilateral chats. Chat rooms have one owner and possible multiple moderators. |
+| Public Group Chat | Chat room without restrictions for users to join. Opposite to private chat rooms needing an invitation by the owner or a moderator. |
+| SNT Burn Rate | ??? |
diff --git a/active/39-chat-moderation/roles.md b/active/39-chat-moderation/roles.md
index 3ff6c55..f5b0972 100644
--- a/active/39-chat-moderation/roles.md
+++ b/active/39-chat-moderation/roles.md
@@ -1,9 +1,9 @@
 # Roles
 
-| Role               | Description                                  |
-|--------------------|----------------------------------------------|
-| Owner              | Creator and owner of a chat.                 |
-| Moderator          | User with rights to moderate a chat.         |
-| User               | Chat user without special rights.            |
+| Role | Description |
+| ---- | ----------- |
+| Owner | Creator and owner of a chat. |
+| Moderator | User with rights to moderate a chat. |
+| User | Chat user without special rights. |
 | Contract Developer | Developer of contracts especially for chats. |
-| Contract Provider  | Provider of contracts especially for chats.  |
+| Contract Provider | Provider of contracts especially for chats. |
diff --git a/active/39-chat-moderation/user-stories/us-1-blocking-a-user.md b/active/39-chat-moderation/user-stories/us-1-blocking-a-user.md
index c35390f..96489a1 100644
--- a/active/39-chat-moderation/user-stories/us-1-blocking-a-user.md
+++ b/active/39-chat-moderation/user-stories/us-1-blocking-a-user.md
@@ -37,4 +37,4 @@ Also in other chat rooms with both users *User A* doesn't see any post of *User
   participants and can be selected to open a menu like for blocking? Or does the chat
   room menu an option to list all blocked users and those can be unblocked there?
 - Question: How is quoting, mentioning, or forwarding of *User B* messages by *User C*
-  handled?
+  handled? Are those visible to *User A*?
diff --git a/active/39-chat-moderation/user-stories/us-2-reducing-spam.md b/active/39-chat-moderation/user-stories/us-2-reducing-spam.md
new file mode 100644
index 0000000..bb9cab6
--- /dev/null
+++ b/active/39-chat-moderation/user-stories/us-2-reducing-spam.md
@@ -0,0 +1,40 @@
+# User Story 2: Reducing SPAM
+
+## Description
+
+*User A* enters a public group chat. *User A* discovers that messages in the chat
+feed are low quality (SPAM). *User A* adjusts the required SNT burn value until the
+quality of the chat feed improves.
+
+## Trigger
+
+Wish of *User A* to reduce SPAM in a public group chat.
+
+## Actors
+
+- *User A*
+
+## Pre-Condition
+
+A public chat room with traffic and *User A* as a user. *User A* decides that the
+quality of the feed doesn't match her quality requirements, the messages contain
+too much SPAM.
+
+## Post-Condition
+
+After adjustment of the required SNT burn value the amount of SPAM reduces.
+
+## Flow
+
+- *User A* enters a public chat room and discovers the low feed quality.
+- *User A* selects his settings for the chat room and changes the SNT burn rate.
+- After changing the burn rate the amount of SPAM varies.
+
+## Remarks
+
+- Question: Do chat rooms have a standard burn rate?
+- Question: Do chat rooms have upper or lower limits for burn rate?
+- Question: How does the SNT burn rate of *User A* influences the delivery
+  of low or high quality messages?
+- Question: Can a sender influence what it's worth to her having a message
+  delivered?