deprecations/cosmetics (#421)

- deprecate rss channel since broken for ages - deprecate bot functions which were broken for ages too - be more detailed about chat relays - general wording/cosmetics
armbian · May 30, 2024 · 41c0654 · 41c0654
1 parent 41edcdf
commit 41c0654
Showing 1 changed file with 22 additions and 38 deletions.
diff --git a/docs/Community_IRC.md b/docs/Community_IRC.md
@@ -2,35 +2,35 @@
 
 ## 👏 Overview
 
-As announced in the [forums](https://forum.armbian.com/topic/12803-armbian-irc-channel/) everyone interested can communicate in realtime using the [internet relay chat (or *IRC*)](https://de.wikipedia.org/wiki/Internet_Relay_Chat).
-Well known clients for CLI are [Weechat](https://weechat.org/) or [Irssi](https://irssi.org/) and for GUI [Hexchat](https://hexchat.github.io/). 
+As announced in the [forums](https://forum.armbian.com/topic/12803-armbian-irc-channel/) everyone interested can communicate in realtime using the [internet relay chat (or *IRC* for short)](https://de.wikipedia.org/wiki/Internet_Relay_Chat).
+Well known clients for CLI are [Weechat](https://weechat.org/) or [Irssi](https://irssi.org/) and for GUI [Hexchat](https://hexchat.github.io/) or [Konversation](https://konversation.kde.org/). 
 
 Besides that communication is also possible via *Discord*.
 
-## 🔌 Connect
+## 🔌 How to connect
 
 ### IRC
 
-Libera:
+Libera network:
 
 - Server: `irc.libera.chat` 
 - Ports: `6697` / non-encrypted: `6667` 
 - Channel: `#armbian` 
 
-OFTC:
+OFTC network:
 
 - Server: `irc.oftc.net` 
 - Ports: `6697` / non-encrypted: `6667` 
 - Channel: `#armbian`
 
-In order to enter main `#armbian` channels registration with Nickserv is mandatory. Check [Libera Chat documentation](https://libera.chat/guides/registration) for further information.
+In order to enter main `#armbian` channels registration with Nickserv is mandatory on Libera. Check [Libera Chat documentation](https://libera.chat/guides/registration) for further information.
 
 ### Discord
 
 Simply click here: [https://discord.com/invite/armbian](https://discord.com/invite/armbian) 
 
-Channels starting with `#armbian-` are relayed between Discord and Libera IRC so it does not matter if you join IRC or Discord as both receive your messages. Check `#welcome-and-rules` for more information.
-The main `#armbian` channel and `#armbian-announcements` are relayed between Discord, Libera IRC and OFTC IRC.
+Channels starting with `#armbian-` are relayed between Discord and Libera IRC so it does not matter if you join IRC or Discord as both ends receive your messages. Check `#welcome-and-rules` for more information.
+The main `#armbian` channel and `#armbian-announcements` are relayed between Discord, Libera and OFTC.
 
 ## 🛑 Rules
 
@@ -39,44 +39,31 @@ Forums registration terms and rules apply for our chats: [https://forum.armbian.
 ## 💬 Channels
 
 - **`#armbian`** is the project's main channel. Issue tracking, peer-to-peer user support or [upcoming release planning talks](https://docs.armbian.com/Process_Release-Model/#release-planning).
-- **`#armbian-announcements`** : important messages from the Armbian team. You definitely want to idle here. Moderated channel.
+- **`#armbian-announcements`** : important messages from the Armbian team. You definitely want to idle here. Moderated channel
 - **`#armbian-devel`** : build engine development topics
 - **`#armbian-desktop`** : desktop environment development
-- **`#armbian-csc`** unsupported/deprecated board talk
-- **`#armbian-allwinner`** Allwinner SoC talk
-- **`#armbian-amlogic`** Amlogic SoC talk
-- **`#armbian-broadcom`** Broadcom SoC talk
-- **`#armbian-rockchip`** Rockchip SoC talk
-- **`#armbian-offtopic`** General chit chat
-- **`#armbian-commits`** is a moderated channel. Whenever a new interaction with a [repository on Github](https://github.com/armbian/) happens it will be announced. Also newly added issues on [Jira](https://armbian.atlassian.net/projects/AR/issues/?filter=allissues) will be pasted. User chat is not possible.
-- **`#armbian-rss`** is a live forum feed. Whenever a new post in the Armbian Forums is made it will be announced here. User chat is not possible.
-Of course, you can also enable desktop notification in your favorite browser for the forums.
-
-Everybody is free to join any of these channels.
-We may or may not add more channels in future depending on the needs.
+- **`#armbian-csc`** unsupported/stating board talk
+- **`#armbian-allwinner`** Allwinner-related SoC talk
+- **`#armbian-amlogic`** Amlogic-related SoC talk
+- **`#armbian-broadcom`** Broadcom-related SoC talk
+- **`#armbian-rockchip`** Rockchip-related SoC talk
+- **`#armbian-offtopic`** General chit chat, whatever that does not fit other channels
+- **`#armbian-commits`** Whenever a new interaction with a [repository on Github](https://github.com/armbian/) happens it will be announced. Also newly added issues on [Jira](https://armbian.atlassian.net/projects/AR/issues/?filter=allissues) will be pasted. Moderated channel
 
 ## 👮 Services
 
 Besides the services offered by IRC (like Nickserv or Chanserv) Armbian has set up some own services (on Libera only). 
 
 **`ArmbianGithub`**
 
-- Has the purpose to fill #armbian-commits and #armbian-rss like described above
+- Has the purpose to fill #armbian-commits channel
 
 **`DC-IRC`**
 
-- Has the purpose to relay messages between IRC and Discord. Applies for all channels beginning with `#armbian-`.
-
-<!---**`ArmbianTwitter`**
-
-- Recurring searches on Twitter for new Tweets from [*@armbian*](https://twitter.com/armbian) and when people are actually mentioning *Armbian*-->
+- Has the purpose to relay messages between the IRC networks and Discord. Applies for all channels beginning with `#armbian-` as well as `#armbian`.
 
 **`ArmbianHelper`**
 
-- Allows searching for Issues and Task on [Jira](https://armbian.atlassian.net/projects/AR/issues)
- - If you know the actual task id simply write it to the channel and the bot will look it up. Like `AR-123`
- - Search issue by keyword/s in the summary. Like `,searchissue Allwinner H6` 
- Take note of the `,`. Will output up to three results.
 - Allows searching forums via Google API (not very precise though)
  - Example: `,g Allwinner H6 panfrost`
 - A few more minor commands, mostly used by staff or do not need introduction
@@ -88,18 +75,17 @@ Besides the services offered by IRC (like Nickserv or Chanserv) Armbian has set
 ## ❔ FAQ
 
 - Why are there so many people in the channel and nobody is talking? 
- - It is pretty common for community IRC channels for people to simply *idle* there. Many also using so called IRC bouncers <https://en.wikipedia.org/wiki/BNC_(software>) that keeps their connection to the channel alive.
+ - It is pretty common for community IRC channels for people to simply *idle* there. Many also using so called IRC bouncers <https://en.wikipedia.org/wiki/BNC_(software>) that keeps their connection to the channel alive to act like an answering machine.
 
 - I wrote 'Hi' but nobody answered. How do I get support there?
  - Probably there is nobody around at the time. Keep in mind that all users are spread around the globe and therefore living in many different time zones. 
  It is a common habit to simply state your question or issue and then wait patiently for an answer. Depending how complex this may take up to a few hours because most Armbian contributors have detailed knowledge in a specific board family only.
 - Is the chat history public as well?
- - Yes. All conversation is redundantly logged. These logs are open to the public. You can find them here: [http:https://irc.armbian.com](http:https://irc.armbian.com)
+ - Yes. All conversation is logged. These logs are open to the public. You can find them here: [http:https://irc.armbian.com](http:https://irc.armbian.com)
 - Why do some people have odd hostnames like `@armbian/staff/lanefu` or `@user/username`?
  - These *hostnames* are so called project affiliation cloaks. These are meant to show a users affiliation to a specific project and their role there.
 - Can I have that too?
- - Yes. An Armbian affiliation cloak can be requested from *Werner* either via [forums](https://forum.armbian.com/profile/9032-werner/) or IRC. They usually will be granted if you are a well known member in forums, a contributor via Github or donated to the project. Make sure you identified yourself to Nickserv beforehand.
-If you cannot find yourself in the list above you are free to request an unaffiliated cloak from Libera staff. Join #libera for that.
+ - Yes. An Armbian affiliation cloak can be requested from *Werner* either via [forums](https://forum.armbian.com/profile/9032-werner/) or IRC. They usually will be granted if you are a well known member in forums, a contributor via Github or donated to the project. Make sure you identified yourself to Nickserv beforehand. 
 - How can I protect my nickname so nobody can spoof me? 
  - Register your nick with Libera's Nickserv service. Check [https://libera.chat/guides/registration](https://libera.chat/guides/registration) 
  Even though it is not mandatory you should register and identify with the services as other channels for example may not allow unregistered users to chat or join at all as anti-spam measure.
@@ -111,6 +97,4 @@ If you cannot find yourself in the list above you are free to request an unaffil
 
 ## 👉 Bottom line
 
-If you have any questions, comments regarding the IRC channels and/or services or found an issue in this documentation for think you can enhance it get in touch with *Werner* either via [forums](https://forum.armbian.com/profile/9032-werner/) or IRC.
-
-By the way if you like to have a free IRC bouncer to always be up-to-date and never miss a conversation again you should check out [this thread](https://forum.armbian.com/topic/13943-irc-bouncer-giveaway/).
+If you have any questions, comments regarding the IRC channels and/or services or found an issue in this documentation for think you can enhance it get in touch with *Werner* either via [forums](https://forum.armbian.com/profile/9032-werner/), IRC or Discord.