Skip to content

Commit ecb2dd1

Browse files
authored
Initial Discord documentation (#304)
* Initial Discord documentation This documentation does not describe how to set up channels, but is otherwise probably sufficient to get newcomers started. I'd like to add an animated GIF to make accessing the Notifications menu clearer, but cannot upload files. right now there is a placeholder -IMAGE GOES HERE-. * Have addressed comments and revised accordingly
1 parent 45176ec commit ecb2dd1

File tree

1 file changed

+42
-2
lines changed

1 file changed

+42
-2
lines changed

src/chat/discord.md

Lines changed: 42 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,44 @@
11
## Discord
22

3-
We haven't yet written the documentation for Discord, but if you'd like to help
4-
out, this is the place for it to go!
3+
Rust's Discord is currently used by a variety of teams such as Community, Ops, and Documentation, as well as their working groups. It is also maintained as a communication tool for Domain Working Groups, and provides a space for general discussion among Rust users, contributors, and beginners.
4+
5+
# Where to go for help with using Discord
6+
Discord's support center provides documentation about its [user interface](https://support.discordapp.com/hc/en-us/categories/200404398) and [account settings](https://support.discordapp.com/hc/en-us/categories/200404358).
7+
8+
# Getting started
9+
10+
1) Understand community standards <br/>
11+
Discord, like all official Rust spaces, is governed by the Code of Conduct. Before joining the conversation there, you can prepare by reading the [Code of Conduct and Moderation Guidelines](https://www.rust-lang.org/community#conduct). C
12+
It is useful to read [Discord's Community Guidelines as well](https://discordapp.com/guidelines)
13+
14+
2) Access channels <br/>
15+
To access the Rust Discord, visit [https://discord.gg/rust-lang](https://discord.gg/rust-lang). If you do not already have a Discord account, you can register for one as part of the process of gaining access. Your first action should be agreeing to our Code of Conduct by following the instructions in #welcome.
16+
17+
3) Configure notifications <br/>
18+
It is a good idea to disable notifications for channels that are not relevant to you, so that you will not be overwhelmed with messages.
19+
Select the expansion arrow next to the server name banner (titled "The Rust Programming Language") and select Notifications from the dropdown. Then follow the configuration instructions provided [on the Discord Support site](https://support.discordapp.com/hc/en-us/articles/215253258-Notifications-Settings-101).
20+
21+
# Appropriate conversation
22+
Discussions should be related to the channel purpose. On team channels, conversation should be related to team business.
23+
All channels are expected to be used for purposes related to the Rust project. Discussion of (for example) wildlife or sightseeing are not appropriate.
24+
25+
# Channels
26+
27+
The following channels are relevant to newcomers to the Rust project:
28+
* welcome - Where you agree to the CoC.
29+
* rust-usage - This is a channel where you can access support for resolving specific language use questions. The [Rust Users Forum](https://users.rust-lang.org/) is also relevant to your needs.
30+
* beginners - Here, you can meet people who began using Rust relatively recently.
31+
* contribute - Interested in contributing to the Rust project? In addition to joining this channel, you can subscribe to the [This Week In Rust](https://this-week-in-rust.org/) newsletter, where many opportunities are regularly posted.
32+
It may also help to find out more about [specific teams](https://www.rust-lang.org/governance#teams).
33+
34+
Channels outside of General are for contributors to Rust.
35+
36+
# Messages
37+
Discord conversation takes place when people are available, so you should not generally expect that your messages will receive a response quickly unless a meeting is taking place. Depending on how your notifications are configured, you will see a red circle on top of the Discord icon in your system tray when new messages are received. If you wish to communicate with a specific individual, right-click on their user icon and select "Message" in the dropdown menu.
38+
39+
# Read-only view
40+
Set up a Discord account (as described in Getting Started, above) in order to access Discord. There is not
41+
currently a read-only archive view available.
42+
43+
44+

0 commit comments

Comments
 (0)