1
0
mirror of https://github.com/funkypenguin/geek-cookbook/ synced 2025-12-13 01:36:23 +00:00
Files
geek-cookbook/docs/community/matrix.md
David Young b3e7926740 Fix markdown issues
Signed-off-by: David Young <davidy@funkypenguin.co.nz>
2023-02-22 22:33:25 +13:00

5.8 KiB

title, description, icon, status
title description icon status
Geek out with Funky Penguin's Matrix Server Geek out in the Fediverse with our Matrix instance! simple/matrix new

How to geek out in [m]atrix

If you're hesitant to dip your toes into the wall-garden of our Discord server, then Matrix is the place for you!

!!! question "Eh? What's this federated chat thing? Who own my data? (/puts on tin-foil hat) !!" 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...

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 Matrix server?

  1. If you already have a matrix account, you can use it to access our server (the magic of federation). See the channels list below for details
  2. If you don't have an account yet, create one, using your email address, or just login with GitHub
  3. Use the WebUI, or get one of the many available mobile / desktop clients
  4. Join the channels you're interested in (below)! and say hi!

Maybe it's just my years of using Discord, but I expected to be able to enter any search string in the main "search" field in my Matrix client, and have the relevant messages surfaced. Turns out, that's not how it works! The primary "search" field in the Elements UI, for example, searches room names (i.e., show me all the rooms matching the string "chat"). To search within a room, it's necessary to first navigate to that room, and then "room search" is a contextual action you can take within the room. I've not yet found out how do a partial string match though ("chatgpt" matches, but "chatgp" does not).

Code of Conduct

With the goal of creating a safe and inclusive community, we've adopted the Contributor Covenant Code of Conduct, as described here, and use of the Matrix instance is subject to this code of conduct.

Channels

📔 Information

Channel Name Channel Use
#announcements Used for important announcements
#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.

!!! 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