diff options
| author | Felipe Cardoso Resende <felipe@fcresende.dev.br> | 2022-01-22 14:43:32 -0300 |
|---|---|---|
| committer | Drew DeVault <sir@cmpwn.com> | 2022-02-07 17:04:32 +0100 |
| commit | ae28f0ae3ffe5dacadda4742c545b8d91dc6a716 (patch) | |
| tree | 58e79baa373f7a4a34a0b0e89ae7efe9baba3dfd /chat.sr.ht | |
| parent | c4f8ee1f0a967fd2fdd16f1f388561a81bb5d3d7 (diff) | |
| download | sr.ht-docs-ae28f0ae3ffe5dacadda4742c545b8d91dc6a716.tar.gz | |
Improve chat.sr.ht documentation
* Add information about chat.sr.ht UI
* Add information about SASL authentication
Diffstat (limited to 'chat.sr.ht')
| -rw-r--r-- | chat.sr.ht/bouncer-usage.md | 28 |
1 files changed, 22 insertions, 6 deletions
diff --git a/chat.sr.ht/bouncer-usage.md b/chat.sr.ht/bouncer-usage.md index 5488692..626ab9c 100644 --- a/chat.sr.ht/bouncer-usage.md +++ b/chat.sr.ht/bouncer-usage.md @@ -14,7 +14,14 @@ configuring your own IRC client for use with chat.sr.ht. ## Managing your IRC networks -The webchat at [chat.sr.ht] provides a UI for managing your bouncer networks. +The webchat at [chat.sr.ht] provides a UI for managing your bouncer networks. On +the chat.sr.ht tab, you can add new network using the `Add network` button on +the top-right of the screen. + +When a new network is added, a tab is created for it and there you can join a +channel using the `Join channel` button or manage the network settings using the +`Manage network` button. + Third-party clients with soju support may detect the bouncer and offer similar functionality. If not, you can also message BouncerServ to configure soju. Use `/msg BouncerServ help` for a full list of supported commands. @@ -34,12 +41,21 @@ See [soju(1)] for details on the supported options. In IRC, communicating with a user requires knowing their "nickname" ("nick" for short). Traditionally, IRC would allow users to pick any nick they like -- even one commonly used by someone else. Today, in order to "register" a nick so that -others cannot use it, a system called SASL is used. chat.sr.ht uses SASL to -automatically log you in to the networks you use, and prompts you for your login -details when you first connect to a new network. +others cannot use it, a system called SASL is used. See +[Nickname Registration][libera.chat-registration] for details on how to register +a nickname on Libera Chat. + +[libera.chat-registration]: https://libera.chat/guides/registration + +chat.sr.ht uses SASL to automatically log you in to the networks you use, and +prompts you for your login details when you first connect to a new network. + +If you didn't provide your SASL credentials when connecting to the network, you +can do it afterwards by going into the network tab you want to authenticate and +click the `authenticate` link. -SASL can be manually configured for soju(1) using BouncerServ; see the `sasl` -command (try `help sasl`). +Additionally, SASL can be manually configured for soju(1) using BouncerServ; +see the `sasl` command (try `/msg BouncerServ help sasl set-plain`). Note that IRC networks are independent with regards to nickname registration; you must register your nickname manually for every IRC network you use. Beware |