From f12e709a4078c18c8033fb320c57222c10d9130b Mon Sep 17 00:00:00 2001 From: Karl Stevens Date: Mar 21 2023 13:27:31 +0000 Subject: Changes based on comments in PR #186 --- diff --git a/project/modules/ROOT/pages/communications.adoc b/project/modules/ROOT/pages/communications.adoc index 7388d3b..5c1bf35 100644 --- a/project/modules/ROOT/pages/communications.adoc +++ b/project/modules/ROOT/pages/communications.adoc @@ -6,41 +6,50 @@ This current page goes into more detail around the various communication channel == Primary Channels -We now use https://chat.fedoraproject.org[Matrix/Element] as the primary synchronous channel to speak to each other in real time. The xref:help.adoc[Getting Help] page has more background on why we chose this platform over IRC. +=== Chat -You can find a list of the Fedora channels on Matrix https://chat.fedoraproject.org/#/room/#fedora-space:fedoraproject.org[here]. Most of these channels are mirrored on IRC at Libera Chat as well as on Telegram where you can just search for "fedora". +We now use https://chat.fedoraproject.org[Matrix/Element] as the primary synchronous channel to speak to each other in real time. -https://discussion.fedoraproject.org/c/ask/6/none[Ask Fedora] is the main community knowledge base and support forum hosted by the Fedora Project within Fedora Discussion (below). Ask Fedora is a good place to go for support and troubleshooting help, as mentioned on the xref:help.adoc[Getting Help] page. +You can find a list of the Fedora channels on Matrix https://chat.fedoraproject.org/#/room/#fedora-space:fedoraproject.org[here]. +Most of these channels are mirrored on IRC at Libera Chat. -Ask Fedora sits within https://discussion.fedoraproject.org/c/ask/6/none[Fedora Discussion], where you will find all the latest news & announcments, as well as discussion about open source projects; workflows, and Fedora-specific offerings such as the Fedora Editions. See also under xref:help.adoc[Getting Help]. +=== Fedora Discussion -Mailing Lists are for longer asynchronous discussions for which short-lived chats may not be enough. -For a catalog of all the mailing lists look at https://lists.fedoraproject.org/[lists.fedoraproject.org]. -Most significant for newer members would be the following: +https://discussion.fedoraproject.org/c/ask/6/none[Fedora Discussion] is the primary dicussion forum where you will find all the latest news & announcements, as well as discussion about open source projects; workflows, and Fedora-specific offerings such as the Fedora Editions. +See also under xref:help.adoc[Getting Help]. -* https://lists.fedoraproject.org/archives/list/announce@lists.fedoraproject.org/[announce] -* https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/[devel] -* https://lists.fedoraproject.org/archives/list/devel-announce@lists.fedoraproject.org/[devel-announce] -* https://lists.fedoraproject.org/archives/list/test@lists.fedoraproject.org/[test] +=== Ask Fedora -== Other Communication Channels +https://discussion.fedoraproject.org/c/ask/6/none[Ask Fedora] sits within Fedora Discussion and is the main community knowledge base and support forum hosted by the Fedora Project. +Ask Fedora is a good place to go for support and troubleshooting help, as mentioned on the xref:help.adoc[Getting Help] page. -Within the Fedora Pagure source control repository https://pagure.io/Fedora-Council/council-docs/issues[issues] are posted, discussed, assigned and remediated. Here you can raise issues or view, comment on, and request to act on open issues. -At https://forums.fedoraforum.org/[fedoraforum.org] you'll find an external support community. +== Other Communication Channels -https://fedoramagazine.org[Fedora Magazine] is a great resource for user-facing announcements and cool stories about usage, features, etc... +As above, https://discussion.fedoraproject.org/c/ask/6/none[Fedora Discussion] is now the primary platform for longer asynchronous discussions where short-lived chats may not be enough. +Some teams do still use mailing lists though. +The most significant mailing lists are: -https://communityblog.fedoraproject.org[Fedora Community Blog] brings you contributor-facing announcements and updates. Within the Community Blog you'll also find https://communityblog.fedoraproject.org/tag/fridays-fedora-facts/[Friday's Fedora Facts]. These are weekly posts with status updates, schedule info, etc.. +* https://lists.fedoraproject.org/archives/list/announce@lists.fedoraproject.org/[announce] +* https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/[devel] +* https://lists.fedoraproject.org/archives/list/devel-announce@lists.fedoraproject.org/[devel-announce] +* https://lists.fedoraproject.org/archives/list/test@lists.fedoraproject.org/[test] +For a catalog of all the mailing lists look at https://lists.fedoraproject.org/[lists.fedoraproject.org] -On Twitter you can find discussion at https://twitter.com/fedorausers[@fedorausers] and https://twitter.com/fedora[@fedora] +https://fedoramagazine.org[Fedora Magazine] is a great resource for user-facing announcements and cool stories about usage, features, etc... -On reddit at https://www.reddit.com/r/Fedora/[r/Fedora] +https://communityblog.fedoraproject.org[Fedora Community Blog] brings you contributor-facing announcements and updates. +Within the Community Blog you'll also find https://communityblog.fedoraproject.org/tag/fridays-fedora-facts/[Friday's Fedora Facts]. +These are weekly posts with status updates, schedule info, etc.. -On Discord at https://discord.com/invite/fedora[Fedora Linux] +The Fedora Pagure source control repository allows posting of https://pagure.io/Fedora-Council/council-docs/issues[issues] which can be discussed, assigned and remediated. +Here you can raise issues or view, comment on, and request to act on open issues. +There are a number of official and other social media accounts, on various networks. +You can find details of these documented on the https://fedoraproject.org/wiki/Marketing_social_networks[Marketing Social Networks] Wiki page. == Etiquette + In all our interactions, we aspire to _be excellent to each other_. Read the xref:code-of-conduct.adoc[Code of Conduct] to learn more of what is expected of Fedora community members. diff --git a/project/modules/ROOT/pages/help.adoc b/project/modules/ROOT/pages/help.adoc index 3f1b372..7570159 100644 --- a/project/modules/ROOT/pages/help.adoc +++ b/project/modules/ROOT/pages/help.adoc @@ -28,5 +28,6 @@ Fedora Chat on Matrix is the preferred platform for the future of Fedora Chat, h If you're interested in *why* Fedora's primary communications are moving to Matrix, check out https://www.youtube.com/watch?v=Z2A8BdU1gKg[this presentation] on the Fedora YouTube channel by Fedora Project Leader Matthew Miller. == Bugzilla -If you believe you've found a bug you can report it through Bugzilla. -The https://docs.fedoraproject.org/en-US/quick-docs/bugzilla/["Using Bugzilla"] page in https://docs.fedoraproject.org/en-US/quick-docs/[Fedora Quick Docs] will give you any guidance you need to do this. You can also ask on https://discussion.fedoraproject.org/c/ask/6/none[Ask Fedora] to get advice on filing a good bug report. +If you believe you've found a bug you can report it through https://bugzilla.redhat.com/[Bugzilla]. +The xref:quick-docs::bugzilla/index.adoc["Using Bugzilla"] page will give you any guidance you need to do this. +You can also ask on https://discussion.fedoraproject.org/c/ask/6/none[Ask Fedora (as above)] to get advice on filing a good bug report. diff --git a/project/modules/ROOT/pages/join.adoc b/project/modules/ROOT/pages/join.adoc index 370ff27..9a0ab4e 100644 --- a/project/modules/ROOT/pages/join.adoc +++ b/project/modules/ROOT/pages/join.adoc @@ -22,7 +22,7 @@ Fedora is a xref:orgchart.adoc[massive global organisation] where people with ma All services used by the Fedora community are linked to a central Fedora account. If you're intending to get involved you should get one https://accounts.fedoraproject.org/[here]. -There is an excellent https://fedoramagazine.org/how-to-contribute-to-fedora/#:~:text=The%20first%20step%20for%20contributing,Special%20Interest%20Group%20(SIG)[article in Fedora Magazine] covering in some detail the various ways you might get started. +There is an excellent https://fedoramagazine.org/how-to-contribute-to-fedora/[article in Fedora Magazine] covering in some detail the various ways you might get started. == Not sure where to start? Come hang out with us! @@ -30,9 +30,10 @@ The large scale of the community can sometimes make it a little daunting for new There is far too much happening in Fedora all the time---even we find it hard to keep up with it all! So, if you are not sure of where to begin or have any queries at all, come hang out with the xref:fedora-join::index.adoc[Fedora Join Special Interest Group (SIG)] on any of our channels: -- Email: https://lists.fedoraproject.org/archives/list/fedora-join@lists.fedoraproject.org/[Fedora Join mailing list], - Chat (over Matrix/Element): https://chat.fedoraproject.org/#/room/#join:fedoraproject.org[Join Fedora on Matrix/Element], +- Email: https://lists.fedoraproject.org/archives/list/fedora-join@lists.fedoraproject.org/[Fedora Join mailing list], + Here, you can speak to community members and other newcomers while we explore Fedora together. We will help you learn the systems and processes that the Fedora community uses, and as you gain a better idea of where you would like to contribute, we will also help you learn the skills that you may need.