From 611341d3f05a3d1ae993515f039d153c3ebad315 Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Sun, 3 Jul 2022 01:47:02 +1000 Subject: [PATCH] doc/dev: add IRC registration instructions This PR adds to the Developer Guide a link to the OFTC's IRC nick registration instructions. (cherry picked from commit 893e68a8f57b22cc025c82586ad0b42da2a6477c) --- doc/dev/developer_guide/essentials.rst | 42 ++++++++++++++++++++++++-- 1 file changed, 40 insertions(+), 2 deletions(-) diff --git a/doc/dev/developer_guide/essentials.rst b/doc/dev/developer_guide/essentials.rst index 96413628e3ecf..a4d716d23c200 100644 --- a/doc/dev/developer_guide/essentials.rst +++ b/doc/dev/developer_guide/essentials.rst @@ -139,8 +139,46 @@ using `Internet Relay Chat`_. .. _`Internet Relay Chat`: http://www.irchelp.org/ -See ``https://ceph.com/irc/`` for how to set up your IRC -client and a list of channels. +The Ceph community gathers in the #ceph channel of the Open and Free Technology +Community (OFTC) IRC network. + +Created in 1988, Internet Relay Chat (IRC) is a relay-based, real-time chat +protocol. It is mainly designed for group (many-to-many) communication in +discussion forums called channels, but also allows one-to-one communication via +private message. On IRC you can talk to many other members using Ceph, on +topics ranging from idle chit-chat to support questions. Though a channel might +have many people in it at any one time, they might not always be at their +keyboard; so if no-one responds, just wait around and someone will hopefully +answer soon enough. + +Registration +^^^^^^^^^^^^ + +If you intend to use the IRC service on a continued basis, you are advised to +register an account. Registering gives you a unique IRC identity and allows you +to access channels where unregistered users have been locked out for technical +reasons. + +See ``the official OFTC (Open and Free Technology Community) documentation's +registration instructions +`` to learn how to +register your IRC account. + +Channels +~~~~~~~~ + +To connect to the OFTC IRC network, download an IRC client and configure it to +connect to ``irc.oftc.net``. Then join one or more of the channels. Discussions +inside #ceph are logged and archives are available online. + +Here are the real-time discussion channels for the Ceph community: + + - #ceph + - #ceph-devel + - #cephfs + - #ceph-dashboard + - #ceph-orchestrators + - #sepia .. _submitting-patches: -- 2.39.5