~sircmpwn/sr.ht-docs

ae28f0ae3ffe5dacadda4742c545b8d91dc6a716 — Felipe Cardoso Resende 3 months ago c4f8ee1
Improve chat.sr.ht documentation

* Add information about chat.sr.ht UI
* Add information about SASL authentication
1 files changed, 22 insertions(+), 6 deletions(-)

M chat.sr.ht/bouncer-usage.md
M chat.sr.ht/bouncer-usage.md => chat.sr.ht/bouncer-usage.md +22 -6
@@ 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