From 7e2f68624017ccc90114ee945d955554ae77f48b Mon Sep 17 00:00:00 2001 From: Rishi Gupta Date: Fri, 14 Sep 2018 11:10:23 -0700 Subject: [PATCH] user docs: Add moderating open organizations. --- templates/zerver/for/open-source.md | 12 ++--- .../zerver/help/include/sidebar_index.md | 1 + .../help/moderating-open-organizations.md | 44 +++++++++++++++++++ 3 files changed, 51 insertions(+), 6 deletions(-) create mode 100644 templates/zerver/help/moderating-open-organizations.md diff --git a/templates/zerver/for/open-source.md b/templates/zerver/for/open-source.md index f0ffeb9273..4585935b30 100644 --- a/templates/zerver/for/open-source.md +++ b/templates/zerver/for/open-source.md @@ -25,6 +25,12 @@ Allow anyone to You can also link to your Zulip with a [badge](/help/join-zulip-chat-badge) in your readme document. +### Moderate your community + +Moderation is a big part of making an open community work. Zulip was built +for open communities from the beginning and comes with +[moderation tools](/help/moderating-open-organizations) out of the box. + ### Authenticate with GitHub Allow (or require) users to @@ -56,12 +62,6 @@ Efficiently refer to issues or code reviews with notation like `#1234` or [custom linkification filter](/help/add-a-custom-linkification-filter) for your organization. -### Enforce a code of conduct - -Link to your community norms or give other instructions right on your Zulip -registration page. Admins can delete messages and deactivate (ban) users at -any time. - ### Hundreds of integrations Get events from GitHub, Travis CI, JIRA, and diff --git a/templates/zerver/help/include/sidebar_index.md b/templates/zerver/help/include/sidebar_index.md index 952a5741ac..527106c0d1 100644 --- a/templates/zerver/help/include/sidebar_index.md +++ b/templates/zerver/help/include/sidebar_index.md @@ -114,6 +114,7 @@ * [Manage who can join](/help/manage-who-can-join-and-invite) * [Set the default language for new users](/help/change-the-default-language-for-your-organization) * [Export your organization](/help/export-your-organization) +* [Moderating open organizations](/help/moderating-open-organizations) * [Deactivate your organization](/help/deactivate-your-organization) * [GDPR Compliance](/help/gdpr-compliance) diff --git a/templates/zerver/help/moderating-open-organizations.md b/templates/zerver/help/moderating-open-organizations.md new file mode 100644 index 0000000000..4ddc0da6a9 --- /dev/null +++ b/templates/zerver/help/moderating-open-organizations.md @@ -0,0 +1,44 @@ +# Moderating open organizations + +Zulip aims to be the best chat possible for open organizations. Moderation +is a big part of making an open community work. + +## Prevention + +* [Disallow disposable email addresses](/help/manage-who-can-join-and-invite), + or [require users to log in via GitHub](/help/configure-authentication-methods). +* Restrict who can [create streams](/help/configure-who-can-create-streams), + [create bots](/help/restrict-bot-creation) or + [add custom emoji](/help/only-allow-admins-to-add-emoji). +* Link to a code of conduct in your + [organization description](/help/create-your-organization-profile) + (displayed on the registration page). +* Create at least one + [default stream](/help/set-default-streams-for-new-users) where only + admins can post. + +## Response + +* [Ban (deactivate) users](/help/deactivate-or-reactivate-a-user) acting in + bad faith. You can reactivate them later if they repent. +* Delete messages, [delete streams](/help/delete-a-stream), and + [unsubscribe users from streams](/help/add-or-remove-users-from-a-stream). +* Rename topics. +* [Change users' names](/help/change-a-users-name) (e.g. to "Spammer") +* [Deactivate bots](/help/deactivate-or-reactivate-a-bot) or + [delete custom emoji](/help/add-custom-emoji#delete-a-custom-emoji). + +## In the works + +* **Mark as spam**. This will allow non-admins to collectively impose a + temporary ban on a user. +* **Delete spammer**. This will wipe the user from your Zulip, by deleting + all their messages and reactions, banning them, etc. +* **Mute user**. This will allow an individual user to hide the messages of + another individual user. +* **New users join as guests**. This will allow users joining via open + registration to have extremely limited permissions by default, but still + enough permissions to ask the core team a question or to get a feel for your + community. +* **Public archive**. This will give a read-only view of selected streams, + removing the need in some organizations for having open registration.