===== FreeBSD Discord =====

%%FreeBSD%% has a Discord server to socialize, get support, support others, learn, contribute, collaborate, and stay up to date on all things %%FreeBSD%% and Open Source.

Everyone is welcome to [[https://discord.gg/freebsd|Join our FreeBSD Discord Server]]. This invitation will take you to our [[https://discord.com/channels/727023752348434432/727023752348434436|#lobby]] channel.

If the above invitation link doesn't work, [[https://discord.com/invite/n2wshsy|use this FreeBSD Discord Invitation]]

==== Why Discord? ====

[[wikipedia>Discord_(software)|Discord]]:

  * is broadly accessible 
  * is popular with non-technical people
  * broadens the appeal of %%FreeBSD%% beyond traditional spaces and audiences
  * is commonly used by gaming communities, also used by many others
  * has unique features that do not require a steep learning curve.

==== Guidelines & Rules ====

Our %%FreeBSD%% Discord server rules and guidelines are additional, and complementary, to the [[https://www.freebsd.org/internal/code-of-conduct/|FreeBSD Code of Conduct]].

While we don't have strict 'on-topic' rules, the following types of content are **never** acceptable, and are grounds for immediate removal without notice:

  * [[https://en.wikipedia.org/wiki/Not_safe_for_work|NSFW]] or obscene content (including text, images, or links featuring nudity, sex, violence and other disturbing content)
  * Links to, or sharing of, copyright or pirated material
  * Content that is, or could be considered, discriminatory.

Note: It is challenging to describe crystal clear boundaries for including and excluding particular content, which means the above guidelines are not exhaustive. We expect community members to always exercise their best judgement, with the primary consideration and priority being the health and well-being of the %%FreeBSD%% community.

=== Trolling and Troll-like Behaviour ===

Please also note the following definitions of trolling or troll-like behaviour:

  * Behaviour that is designed to cause an argument, flame war, heated debate, or anything along these lines;
  * Making unsubstantiated statements or claims without providing evidence, especially when you attempt to claim others should provide the evidence or "Google it";
  * Making a statement that is obviously false or highly subjective, without providing evidence;
  * Being obnoxious and attempting to get a "rise" out of another community member with clearly provocative language, statements, reactions, GIFs, etc.

Trolling behaviour will be treated accordingly by Community Helpers, and may result in being timed out, kicked from the community, or even banned, if warnings are not followed and behaviour isn't adjusted accordingly.

We want this server to be a welcoming space, so if you see something against the rules or that makes you feel unsafe, let us know. You can reach out to Community Helpers by using the ''%%@helper%%'' role and or using the ''%%#helpdesk%%'' channel under the "HELP & SUPPORT" category. You can also attempt to DM a ''%%@helper%%'', but their personal Discord settings might make this difficult.

==== How do I use/access Discord? ====

If you've made the move to %%FreeBSD%% on your desktop/laptop/device, and you're now wondering how you access the %%FreeBSD%% Discord (or just Discord in general), then read on.

Firstly, Discord does not provide an official build of their official client that runs natively on %%FreeBSD%%. Instead, we have to use one of a few options:

  - The Discord client via the browser - basically https://discord.gg/
  - A Electron "wrapper" around the official Discord client
  - A third-party client (please read the notice/warning)

=== The Web Client ===

Using Discord via the web browser is easy: you simply visit https://discord.gg/, login, and you're good to go.

=== The Electron "Wrapper" ===

Using the Electron "wrapper" is more involved, but well documented: https://github.com/SrWither/DiscordBSD

This one is recommended simply because it's the most up to date based on the last commit date.

=== Third-party Clients ===

<callout type="info">
Please note that the %%FreeBSD%% project or Foundation cannot suggest or recommend the use of third-party Discord clients. We cannot guarantee that is permitted under Discord's T&Cs, AUP, and beyond. Please check that your use of a third-party is legal under the terms of service provided by Discord themselves.
</callout>

Here is a list of third-party Discord clients, each with their own respective pros and cons, install instructions, and more:

  - gtkcord4 – [[https://www.freshports.org/net-im/gtkcord4/|net-im/gtkcord4]]
  - https://github.com/diamondburned/6cord (**deprecated and marked a read-only! Be careful!**)

==== Channel Overview ====

Channels are organised into five high-level **user-goal** oriented categories, to help you find what you're looking for:

  * **SOCIALIZE** - Connecting and enjoying time with other people in the community.
  * **HELP & SUPPORT** - Getting help, helping and supporting others.
  * **LIVE** - Real-time events, streams and other //live// content.
  * **LEARN & CONTRIBUTE** - Leveling up knowledge, participating and contributing.
  * **PULSE** - Staying informed and up-to-date.

===== Organisation =====

==== Principles ====

Principles and guidelines that inform our behaviours, decision-making and evolution:

  * Casual, relaxed, fun and authentic is the flavour here. ((This does not mean no moderation, potty mouths or not considering the impact of what we say))
  * Prioritize, leverage and focus on Discord's **unique** features. ((This means voice, video, streaming, social content and services, interactivity and real-time collaboration))
  * Encourage, promote and reward **innovative** and unique or activity, content and creativity.
  * Do things the community does little of or hasn't done before. **Blaze a new trail**.
  * Default to and lean toward **less-is-more** as much as possible.
  * Default to and lean toward as **open, transparent and public** as possible. ((This means having to deal with discomfort, but it's worth it.))
  * Default to and lean toward **continuous progress, change and improvement**. Nothing is set in stone. (("Move fast(er) and minimise breakage". And have a contingency plan.))
  * Respect the user, their time and attention. **Provide real value**. (("pings" are costly. Don't spam.))
  * No engagement for engagement's sake. ((Engagement is not a goal. Genuine, lasting community growth and quality is.))
  * Focus on outcomes, not (only) methods. ((Solutions for undefined problems or without definitions of success are not valuable. Horse > Cart.))
  * Balance dedicated spaces with/versus fragmented activity/groups. ((This is hard.))
  * Remove class distinctions (ideally to zero). Eg: "user", "dev", "committer", "moderator", etc.

==== Team ====

  * You! Get in touch!
  * SeteshStrong (Discord: setesh) - [[#helpers|Community Helper]]: Lead Helper
  * LewisCook (Discord: lcook) - Retired, Original author of [[https://github.com/bsdlabs/pulsar|Pulsar]]
  * VincentMilumJr (Discord: Vince (darkain%%))%%
  * KubilayKocak (Discord: koobs)
  * [[Biti]] (Discord: biti_tiger) - [[#helpers|Community Helper]]: Bot Management
  * MichaelCrilly (Discord: michaelcrilly) - [[#helpers|Community Helper]]
  * AhmadAbdulla (Discord: wolfquin) - [[#helpers|Community Helper]]

==== Community Helpers & Guidelines ====

[[Discord/CommunityHelpers|Community Helpers]] are a team of people recruited from the %%FreeBSD%% community whose primary goal is to encourage and facilitate the highest-quality and best user and community experience possible.

==== Roadmap ====

Roadmap of things we're looking at to improve the experience on and management of our %%FreeBSD%% Discord server.

If you'd like to participate and contribute to our %%FreeBSD%% Discord Roadmap, discussion takes place in our [[https://discord.com/channels/727023752348434432/757543661058654269|#community channel]]

^ Feature ^ Description ^ Status & Responsible ^
| [[https://support.discord.com/hc/en-us/articles/1500000466882-Rules-Screening-FAQ|Rules Screening]] | New members must read/accept guidelines & %%CoC%% before being granted member role | ✔ |
| [[https://support.discord.com/hc/en-us/articles/360047132851-Enabling-Your-Community-Server|Community Server]] Enabled | Additional community management and moderation features | ✔ |
| Moderator 2FA Enabled | Require two-factor authentication for moderator actions | ✔ KubilayKocak |
| [[https://support.discord.com/hc/en-us/articles/360023968311-Server-Discovery|Server Discovery]] Member | Listed in in-app server search. Requires 7,000 members. May apply prior. | KubilayKocak |
| [[https://discord.com/partners|Partnership Program]] Member | Custom URL, Branding, Features, Perks. [[https://support.discord.com/hc/en-us/articles/115001494012|requirements]] | KubilayKocak Status: Applied 20210519 |
| [[https://discord.com/verification|Verified Server]] Enabled | Custom, unique URL, Invite Splash, and Verified Badge | KubilayKocak Status: Applied 20210519 |
| Channel Reorganisation | User Goal-oriented categories | ✔ |
| Set topics in all channels | KubilayKocak | ✔ |
| Discord Announcements | Where/how to we keep members up to date on new things and changes? | ✔ Pinned messages in #community |
| Enable [[https://support.discord.com/hc/en-us/articles/360032008192-Announcement-Channels-|Announcement Channel]] | Does this dupe/replace pinned messages in #community above? | ✔ LewisCook |
| New Member Screening | Use Discord native screening, simplifies perms | ✔ LewisCook |
| Pick Discord Bot Framework | OpenSource, maintained, healthy plugin ecosystem. TODO: Identify 3-5 candidates | [[Biti]] w/ KubilayKocak [[Discord/BotFrameworks]] |
| Admin & Moderation Bot | Enable and document Admin/Moderation Bot | ✔ [[https://dyno.gg/|Dyno]] [[Discord/Bots|Discord/Bots]] |
| Statistics Bot | Server, channel, member statistics | [[Biti]] [[Discord/StatsBotsComparison]] |
| Levels Bot | Gamification and activity/engagement encouragement | [[Biti]] [[Discord/LevelBotsComparison]] |
| Pulse: Review Events | Phabricator Review events in Discord. Use [[https://secure.phabricator.com/book/phabricator/article/webhooks/|Herald:Webhooks]] | KubilayKocak & [[Biti]] |

==== Can I Help? ====

Absolutely! We are keen for members to reach out and talk about how we can best leverage and improve the Discord experience. Some ideas we'd love people to get involved with include:

  * Brainstorm/Suggest unique and creative ideas or features.
  * Provide bug reports and user experience feedback and suggestions.
  * Actively promote Discord in other social media spaces, particularly those that may be new or curious to learn more about %%FreeBSD%%.
  * Contribute to the Wiki page and its content[1].
  * Participate and support other members on Discord.
  * Run a live stream on a %%FreeBSD%%-related topic.
  * Hang out in our live audio and video channels if you're comfortable doing so.

Even the smallest of ideas can go a long way, so get in touch on our Discord:#community channel.

==== Bots ====

We run a number of automated bots on our Discord server, currently:

  * [[https://github.com/bsdlabs/pulsar|Pulsar]]. For:
    * freebsd doc, ports and src commits in the PULSE: [[https://discord.com/channels/727023752348434432/758198891849056256|#commits]] channel.
    * Reaction roles. Ability for people to join a "colour" role with the ''%%!role <colour>%%'' trigger
  * [[https://dyno.gg/|Dyno]]. For:
    * Server change audit logging in PULSE: [[https://discord.com/channels/727023752348434432/760563823156527135|#discord]] channel.

===== See Also =====

[[IRC]]

<callout type="info">
Links to  Discord client software (ports?).
</callout>

===== Invite Sources =====

  * %%RHprKbvWJN%% (quarterly report)
  * n2wshsy (%%FreeBSD%% Wiki)
  * qr3XZ5ZM (13.0-RELEASE Party Audio)
  * xv8BVD7T (13.0-RELEASE Party - #release-party)
  * SYtJEeaDt8 ([[https://mobile.twitter.com/FreeBSDHelp/status/1380664956056522754|@FreeBSDHelp]])
  * AKXU6agYfV (LIVE:#livechat)
  * kAUfqQekcx (Office Hours & AMA)
  * JMJdurE2mK (Collabathon)
  * %%VsGcCwTM%% (#community channel listed on [[Discord/CommunityHelpers]])

----

{{tag>Community Team}}