Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add guides for the InstructLab Discord server #415

Merged
merged 2 commits into from
Dec 17, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 52 additions & 0 deletions InstructLab_DISCORD_GUIDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
# InstructLab Discord Server Guide

The purpose of this document is to inform members about how to join the
[InstructLab Discord Server](https://instructlab.ai/discord) and outline the channels available. We look forward
to meeting everyone and welcoming you to Discord!

## Overview

The InstructLab Discord server can be accessed via this [invitation link](https://instructlab.ai/discord).

Upon joining, you will automatically be assigned the `@Labs` role and gain access to the `#announcements` channel, as
well as a number of the other default channels. You are welcome and encouraged to join other channels that may exist.

All discussions in the InstructLab Discord server are governed by our
[project code of conduct](https://github.com/instructlab/community/blob/main/CODE_OF_CONDUCT.md).

## Opt-in Channels

To ensure that users are not overwhelmed by notifications, we have a few automated channels as opt-in only. In order to
join them, visit the `#welcome-and-rules` channels and react with the emoji corresponding to the channel you wish to
join.

Currently, these channels are:

- `#receive-e2e-logs`: Pushes updates about E2E runs that take place in our GitHub CI, allowing users to watch for failures.

## Moderation and Reporting Abuse

We are an open, welcoming, and inclusive community and expect our members to be kind and respectful in all discourse.

We take reports of harassment very seriously and will address any reports of inappropriate behavior as quickly as possible.

To learn how to report abuse – and to whom you will be reporting – please see our [InstructLab Discord Moderation Guide](https://github.com/instructlab/community/blob/main/InstructLabDiscordModerationGuide.md).

## Having Trouble Joining?

If you are having trouble joining the InstructLab Discord server, please file an issue in the
[community repo](https://github.com/instructlab/community/issues) so we can help you.

TODO: Update with email address to get help once these are set up.

## Private Channels

InstructLab is an open-source project and we value defaulting to open in all of our community communications.
However, there are some cases where discussions must happen in private. For the sake of transparency, we are documenting
these private channels and their purposes.

- `#code-of-conduct-committee` – Space for the InstructLab
[Code of Conduct Committee](https://github.com/instructlab/community/blob/main/CODE_OF_CONDUCT_COMMITTEE.md) to discuss
any reports of harassment or other violations of the project Code of Conduct and how to respond to them.
- `#admin` – Space for the InstructLab Server Administrators to confer privately only when
necessary. We default to open channels and hold each other accountable to do so.
70 changes: 70 additions & 0 deletions InstructLab_DISCORD_MODERATION_GUIDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
# InstructLab Discord Moderation Guide

The purpose of this document is to describe how users of the
[InstructLab Discord server](https://instructlab.ai/discord) can report abuse within the Discord server and to provide
server administrators with an easy-to-use guide for channel moderation.

## Reporting Abuse

Should any community members using the InstructLab Discord server feel that they have experienced behavior that violates
our [project Code of Conduct](https://github.com/instructlab/community/blob/main/CODE_OF_CONDUCT.md), they are welcome
and encouraged to contact the members of the
[Code of Conduct Committee](https://github.com/instructlab/community/blob/main/CODE_OF_CONDUCT_COMMITTEE.md) for help.
Mentioning `@dog-watch` will notify all members of the moderation team so that they can assist you.

In the event that you do not receive help within a timely fashion – and we will do our very best to respond right away –
you can ask for help from the server admins by either joining the `#ask-an-admin` channel or mentioning `@admins`. If
you feel that it is a personal matter, you can also ping one of the people with the role of `#dog-watch` directly.

## Moderation Guide

Moderation activities can only be performed by users who are designated as server administrators (i.e. `@dog-watch`/
`@lead-retriever`).

## Server Administrators

At the time of writing this, anyone with either the `@dog-watch` or `@lead-retriever` role is considered to be a
moderator or administrator respectively.

\+ Members of the
[Code of Conduct Committee](https://github.com/instructlab/community/blob/main/CODE_OF_CONDUCT_COMMITTEE.md)

## How We Moderate

### Deleting Inappropriate Comments

Upon a report of abuse to the [Code of Conduct Committee](https://github.com/instructlab/community/blob/main/COCC.md)
or, alternatively, if needed to the server administrators due to a coverage gap, the appropriate parties will assess
the situation.

The first step will be to remind individuals to abide by the [project Code of Conduct](https://github.com/instructlab/community/blob/main/CODE_OF_CONDUCT.md).

Inappropriate or offensive messages will be deleted. To delete a message, simply click on the three vertical dots that
appear when you hover over a message, or on mobile simply tap and hold on a message, and then click the **Delete**
button:

![Delete Message](https://raw.githubusercontent.com/instructlab/community/main/public/images/discord_delete_message.png)

Deleting a message shall be done at the sole discretion of the Code of Conduct Committee and/or server administrators.

### Removing Server Members

Admins should consider first removing the offending person's messages from the channel in which the unacceptable
behavior occurred and having a conversation with them via Direct Message (DM) to remind them of their responsibilities
to abide by the [project Code of Conduct](https://github.com/instructlab/community/blob/main/CODE_OF_CONDUCT.md) as
part of their participation in the InstructLab community.

If a user is a repeat offender, after being warned, their account can be
[kicked/banned](https://whop.com/blog/how-to-kick-someone-from-a-discord-server/) by an admin, depending on the
situation.

For more details on moderating a Discord server, please refer to the following guides:

- [How to kick someone from a Discord server](https://whop.com/blog/how-to-kick-someone-from-a-discord-server/)
- [Auto Moderation in Discord](https://discord.com/safety/auto-moderation-in-discord)

#### Banning a Member's Account

If you feel that a community member is violating the
[InstructLab Code of Conduct](https://github.com/instructlab/community/blob/main/CODE_OF_CONDUCT.md), please reach out
to the server moderators or the Code of Conduct Committee to receive further assistance.
Binary file added public/images/discord_delete_message.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions requirements.txt
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
# SPDX-License-Identifier: Apache-2.0

tox>=4.4.2,<5
pyspelling
Loading