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.

Sign up for GitHub

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

Jump to bottom

Update the chat information #2106

Merged
merged 1 commit into from
Nov 1, 2023
+22 −42
Merged

Update the chat information #2106

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
64 changes: 22 additions & 42 deletions support.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,61 +69,41 @@ In addition to the [general guidelines](/support.html#CommunityGuidelines) above

(_Credit to the [Fedora Mailing List Guidelines](http://fedoraproject.org/wiki/Communicate/MailingListGuidelines) as a source of ideas, under the Creative Commons Attribution-ShareAlike 3.0 Unported license_)

## [libera.chat](https://libera.chat) {#IRClivechat}
A great place to get real-time help with The Foreman is our IRC channel:
## ![Matrix icon](static/images/matrix.png) [Matrix.org live chat](https://app.element.io/#/room/#theforeman:matrix.org)

* **#theforeman** on [libera.chat](https://libera.chat/)
A great place to get real-time help with The Foreman is our Matrix room:

There are usually many helpful people there in addition to some of the Foreman
developers. For discussions about the intricacies of developing Foreman or
plugins, use the development channel:
Matrix has many [clients](https://matrix.org/docs/projects/try-matrix-now.html)
available, including browser-based, desktop & mobile apps, and even plugins for
venerable clients like WeeChat. Our rooms are in the public directory, but for
reference:

* **#theforeman-dev** on [libera.chat](https://libera.chat/)
* https://app.element.io/#/room/#theforeman:matrix.org
* https://app.element.io/#/room/#theforeman-dev:matrix.org

Please read and understand [this fantastic guide](http://workaround.org/getting-help-on-irc)
to getting help for open-source projects on IRC before diving in. All of the
points there apply to #theforeman, especially "Don't repeat yourself", "Don't
ask to ask", and "Stick around". #theforeman in particular has concentrations
of people in Europe (CEST) and East-coast US (EST), so asking your question
when those time zones are in business hours is more likely to get a good
result.
The Matrix rooms are no longer bridged to the IRC channels (see below).

Be aware that the IRC channel is not an official support channel, it's an ad-hoc
group of people (some of whom work on Foreman for a living) self-organizing
to help each other out. If you do not receive an answer to your question,
(especially if you have not followed the getting help on IRC best practices!),
that doesn’t mean you are out of options; the software may [have a
bug](http://projects.theforeman.org/projects/foreman/issues), the docs may be
lacking, or it's possible Foreman doesn't yet support your use case. It just
means you need to keep troubleshooting to find out which.
### Chat Guidelines

### IRC Guidelines

In addition to the [general guidelines](/support.html#CommunityGuidelines) above, we also have a few IRC-specific guidelines:
In addition to the [general guidelines](/support.html#CommunityGuidelines) above, we also have a few chat-specific guidelines:

* Don't post chunks: Avoid posting big chunks of text - use a [pastebin](http://pastie.org/) or similar service to shorten it to a link. Likewise, try not to spam the channel with many messages, it breaks the flow of other conversations.
* Don't private message: Ask permission before you send someone a private message (PM). Not everyone likes them. Also, by keeping it in public, others with similar issues can see the solution you were given.
* Don't highlight specific people unless you are already discussing something with them. Highlighting a specific user with your opening question makes it far less likely others will respond.

More information: This [IRC primer](https://www.irchelp.org/faq/ircprimer.html) for new users and the [general IRC guidelines, from libera.chat](https://libera.chat/guides), are also useful resources.

(_Thanks to the [Puppet Labs IRC Guidelines](https://puppet.com/community/community-guidelines/#slack-irc-guidelines) for the original document_)

## ![Matrix icon](static/images/matrix.png) [Matrix.org live chat](https://riot.im/app/#/room/#theforeman:matrix.org)

For those wanting something a little less "basic" than IRC, or just would like a
persistent connection, you can also find us on [Matrix.org](https://matrix.org)
- an open standard for interoperable, decentralised, real-time communication
over IP. Matrix has many
[clients](https://matrix.org/docs/projects/try-matrix-now.html) available,
including browser-based, desktop & mobile apps, and even plugins for venerable
clients like WeeChat. Our rooms are in the public directory, but for reference:
Be aware that the support room is not an official support channel, it's an ad-hoc
group of people (some of whom work on Foreman for a living) self-organizing
to help each other out. If you do not receive an answer to your question,
that doesn’t mean you are out of options; the software may [have a
bug](http://projects.theforeman.org/projects/foreman/issues), the docs may be
lacking, or it's possible Foreman doesn't yet support your use case. It just
means you need to keep troubleshooting to find out which.

* https://riot.im/app/#/room/#theforeman:matrix.org
* https://riot.im/app/#/room/#theforeman-dev:matrix.org
## [libera.chat](https://libera.chat) {#IRClivechat}

The Matrix rooms are bridged to the IRC channels, so we're all in the same chat.
Pick which you prefer!
Previously, we had IRC channels here. After the bridging has been decommisioned,
we came to an [agreement](https://community.theforeman.org/t/proposal-on-consolidation-our-chat-platforms/35258) to migrate to Matrix.
While you may still see these channels, they are no longer monitored and are not considered a primary contact.

## ![YouTube icon](static/images/youtube.png) [YouTube channel](https://www.youtube.com/channel/UCCo7AZ1oG6TbG0-dwjRqCmw)
Please subscribe to our [YouTube channel](https://www.youtube.com/channel/UCCo7AZ1oG6TbG0-dwjRqCmw). We regularly upload deep dives on Foreman features, screencasts to learn how to use the different features and plugins of Foreman, discussions and much more.
Expand Down