[main] Doc issue in file project/modules/ROOT/pages/communications.adoc - difficult to join Fedora space with a non-Fedora account #214

Open
opened 2023-12-13 12:31:12 +00:00 by kparal · 1 comment

Today I finally found out how to join the Fedora space on Matrix, and it was far from trivial. The documentation needs improvements.

I already had a matrix.org account, so I didn't want to switch to a fedora.im account (i.e. go through https://chat.fedoraproject.org ). However, the Communication in Fedora doc only has information how to use chat.fp.o, and no other instructions. I can't even see the list of Fedora channels, because it's a link to https://chat.fedoraproject.org/#/room/#fedora-space:fedoraproject.org , which requires a fedora.im account.

After a lot of trials and errors (manually searching for Fedora spaces in Element, on fedoraproject.org and fedora.im domains), the solution for me was to manually create https://matrix.to/#/#fedora-space:fedoraproject.org link and open it, which allowed me to join the top-level Fedora space (which then shows all the sub-spaces and rooms) in Element.

Please adjust the documentation to also provide guidance for people with an existing non-fedora.im account. Something like this:

If you already have an existing (non-Fedora) Matrix account which you want to use, follow this invitation to join the Fedora space, or join #fedora-space:fedoraproject.org manually in your preferred client. This top-level Fedora space lists all sub-spaces and rooms available for you to join.

Thank you.

PS: This sentence should probably be removed, because the IRC bridge doesn't seem to be coming back:

Most of these channels are mirrored on IRC at Libera Chat.

CC @mattdm

Today I finally found out how to join the Fedora space on Matrix, and it was far from trivial. The documentation needs improvements. I already had a `matrix.org` account, so I didn't want to switch to a `fedora.im` account (i.e. go through https://chat.fedoraproject.org ). However, the [Communication in Fedora](https://docs.fedoraproject.org/en-US/project/communications/) doc only has information how to use chat.fp.o, and no other instructions. I can't even see the list of Fedora channels, because it's a link to https://chat.fedoraproject.org/#/room/#fedora-space:fedoraproject.org , which requires a `fedora.im` account. After a lot of trials and errors (manually searching for Fedora spaces in Element, on fedoraproject.org and fedora.im domains), the solution for me was to manually create https://matrix.to/#/#fedora-space:fedoraproject.org link and open it, which allowed me to join the top-level Fedora space (which then shows all the sub-spaces and rooms) in Element. Please adjust the documentation to also provide guidance for people with an existing non-fedora.im account. Something like this: > If you already have an existing (non-Fedora) Matrix account which you want to use, follow [this invitation](https://matrix.to/#/#fedora-space:fedoraproject.org) to join the Fedora space, or join `#fedora-space:fedoraproject.org` manually in your preferred client. This top-level Fedora space lists all sub-spaces and rooms available for you to join. Thank you. PS: This sentence should probably be removed, because the IRC bridge doesn't seem to be coming back: > Most of these channels are mirrored on IRC at Libera Chat. CC @mattdm
Author

I found out that the matrix.to link doesn't allow Fedora Chat users to join :-/ So ideally there should be both links provided - chat.fp.o (for Fedora Chat users) and matrix.to (for other clients).

I found out that the matrix.to link doesn't allow Fedora Chat users to join :-/ So ideally there should be both links provided - chat.fp.o (for Fedora Chat users) and matrix.to (for other clients).
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: Council/council-docs#214
No description provided.