# Discord

The most realtime and exciting way engage with our geeky community is in our [Discord server](http://chat.funkypenguin.co.nz)

!!! question "Eh? What's a Discord? Get off my lawn, young whippersnappers!!"

Yeah, I know. I also thought Discord was just for the gamer kids, but it turns out it's great for a geeky community. Why? [Let me elucidate ya.](https://www.youtube.com/watch?v=1qHoSWxVqtE)..

1. Native markdown for code blocks
2. Drag-drop screenshots
3. Costs nothing, no ads
4. Mobile notifications are reliable, individual channels mutable, etc

## How do I join the Discord server?

1. Create [an account](https://discordapp.com)
2. [Join the geek party](http://chat.funkypenguin.co.nz)!
<!-- markdownlint-disable MD033 -->
<iframe src="https://discordapp.com/widget?id=396055506072109067&theme=dark" width="350" height="400" allowtransparency="true" frameborder="0"></iframe>

## Code of Conduct

With the goal of creating a safe and inclusive community, we've adopted the [Contributor Covenant Code of Conduct](https://www.contributor-covenant.org/), as described [here](/community/code-of-conduct/).

### Reporting abuse

To report a violation of our code of conduct in our Discord server, type `!report <thing to report>` in any channel.

Your report message will immediately be deleted from the channel, and an alert raised to moderators, who will address the issue as detailed in the [enforcement guidelines](/community/code-of-conduct/#enforcement-guidelines).

## Channels

### 📔 Information

| Channel Name       | Channel Use                                                |
|--------------------|------------------------------------------------------------|
| #announcements     | Used for important announcements                           |
| #changelog         | Used for major changes to the cookbook (to be deprecated)  |
| #cookbook-updates  | Updates on all pushes to the master branch of the cookbook |
| #premix-updates    | Updates on all pushes to the master branch of the premix   |
| #discourse-updates | Updates to Discourse topics                                |

### 💬 Discussion

| Channel Name   | Channel Use                                              |
|----------------|----------------------------------------------------------|
| #introductions | New? Pop in here and say hi :)                           |
| #general       | General chat - anything goes                             |
| #cookbook      | Discussions specifically around the cookbook and recipes |
| #kubernetes    | Discussions about Kubernetes                             |
| #docker-swarm  | Discussions about Docker Swarm                           |
| #today-i-learned              | Post tips/tricks you've stumbled across
| #jobs            | For seeking / advertising jobs, bounties, projects, etc |
| #advertisements   | In here you can advertise your stream, services or websites, at a limit of 2 posts per day                           |
| #dev              | Used for collaboratio around current development.                                                    |

### Suggestions

| Channel Name | Channel Use                         |
|--------------|-------------------------------------|
| #in-flight   | A list of all suggestions in-flight |
| #completed   | A list of completed suggestions     |

### Music

| Channel Name     | Channel Use                       |
|------------------|-----------------------------------|
| #music           | DJs go here to control music      |
| #listen-to-music | Jump in here to rock out to music |

## How to get help.

If you need assistance at any time there are a few commands that you can run in order to get help.

`!help` Shows help content.

`!faq` Shows frequently asked questions.

## Spread the love (inviting others)

Invite your co-geeks to Discord by:

1. Sending them a link to <http://chat.funkypenguin.co.nz>, or
2. Right-click on the Discord server name and click "Invite People"

## Formatting your message

Discord supports minimal message formatting using [markdown](https://support.discord.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline-).

!!! tip "Editing your most recent message"
    You can edit your most-recent message by pushing the up arrow, make your edits, and then push `Enter` to save!

## How do I suggest something?

1. Find the #completed channel (*under the **Suggestions** category*), and confirm that your suggestion hasn't already been voted on.
2. Find the #in-flight channel (*also under **Suggestions***), and confirm that your suggestion isn't already in-flight (*but not completed yet*)
3. In any channel, type `!suggest [your suggestion goes here]`. A post will be created in #in-flight for other users to vote on your suggestion. Suggestions change color as more users vote on them.
4. When your suggestion is completed (*or a decision has been made*), you'll receive a DM from carl-bot
