From 1a14eae9ce83943db1d10d10d64a2d8e2c1ca0fb Mon Sep 17 00:00:00 2001 From: Karl Stevens Date: Mar 21 2023 12:47:36 +0000 Subject: Issue #101. Re-arranged side menu; Updated help and join pages and added communications page --- diff --git a/project/modules/ROOT/nav.adoc b/project/modules/ROOT/nav.adoc index 3995b95..8e57391 100644 --- a/project/modules/ROOT/nav.adoc +++ b/project/modules/ROOT/nav.adoc @@ -1,9 +1,10 @@ * xref:index.adoc[Mission and Foundations] * xref:leadership.adoc[Leadership] -* xref:initiatives.adoc[Current Initiatives] * xref:orgchart.adoc[High-Level Organization] * xref:brand.adoc[Brand] +* xref:initiatives.adoc[Current Initiatives] +* xref:communications.adoc[Project Communications] * xref:code-of-conduct.adoc[Code of Conduct] ** xref:coc-clarifying.adoc[Clarifying Notes and Statements] -* xref:help.adoc[Get Help] +* xref:help.adoc[Getting Help] * xref:join.adoc[Get Involved] diff --git a/project/modules/ROOT/pages/communications.adoc b/project/modules/ROOT/pages/communications.adoc new file mode 100644 index 0000000..7388d3b --- /dev/null +++ b/project/modules/ROOT/pages/communications.adoc @@ -0,0 +1,46 @@ += Communication in Fedora + +As referenced on the xref:join.adoc[Get Involved] page below, Fedora is a massive global organisation with many people with different skills carrying out different roles. +As you get involved you may need to find assistance and the xref:help.adoc[Getting Help] page can help you with that. +This current page goes into more detail around the various communication channels within the Project. + +== 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. + +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". + +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. + +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]. + +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://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] + +== Other Communication Channels + +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. + +https://fedoramagazine.org[Fedora Magazine] is a great resource for user-facing announcements and cool stories about usage, features, etc... + +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 Twitter you can find discussion at https://twitter.com/fedorausers[@fedorausers] and https://twitter.com/fedora[@fedora] + +On reddit at https://www.reddit.com/r/Fedora/[r/Fedora] + +On Discord at https://discord.com/invite/fedora[Fedora Linux] + + +== 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 b5b066b..3f1b372 100644 --- a/project/modules/ROOT/pages/help.adoc +++ b/project/modules/ROOT/pages/help.adoc @@ -1,17 +1,32 @@ = Getting Help +There are several places to find help: -== Ask Fedora -https://ask.fedoraproject.org/[Ask Fedora] is a community knowledge base and support forum hosted by the Fedora Project. +== Quick Docs +Firstly, https://docs.fedoraproject.org/en-US/quick-docs/[Fedora Quick Docs] is a collection of short HOWTO and FAQ style documentation for Fedora users. + +== Fedora Documentation +Then there is the https://docs.fedoraproject.org/en-US/docs/[official documentation]. +Many answers can be found here. +If you don't find what you need in the documentation or you need more detail, you can ask a question via the forums below. + +== Fedora Discussion +Fedora has a strong community that is ready to help you. +Because users and contributors span the globe, a key element to the project is communication. +See the xref:communications.adoc[Project Communications] page for more details. + +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). Visit Ask Fedora for support and troubleshooting help. +Within https://discussion.fedoraproject.org/[Fedora Discussion] you will find all the latest news & announcments. +It is also the place to talk about open source projects, workflows, and Fedora-specific offerings such as the Editions: +Fedora Workstation, Fedora Server, Fedora CoreOS, Fedora Silverblue, and more.... + == Fedora Chat -Visit Fedora’s official chat platform, -https://chat.fedoraproject.org (powered by Matrix). +https://chat.fedoraproject.org[Fedora’s official chat platform] (powered by Matrix) is the place to go for more synchronous, real time communication. +Fedora Chat on Matrix is the preferred platform for the future of Fedora Chat, however many of the Fedora Linux channels on IRC at Libera Chat are still bridged to Fedora Chat on Matrix to allow continued use of IRC during the transition. -== Fedora Discussion -https://discussion.fedoraproject.org/[Fedora Discussion] is a place to talk about open source projects, workflows, and Fedora-specific offerings -such as Fedora Workstation, Fedora Server, Fedora CoreOS, -Fedora Silverblue, and more. +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. -== Quick Docs -https://docs.fedoraproject.org/en-US/quick-docs/[Fedora Quick Docs] is a collection of short HOWTO and FAQ style documentation for Fedora users. +== 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. diff --git a/project/modules/ROOT/pages/join.adoc b/project/modules/ROOT/pages/join.adoc index c41bbce..370ff27 100644 --- a/project/modules/ROOT/pages/join.adoc +++ b/project/modules/ROOT/pages/join.adoc @@ -1,26 +1,28 @@ -= Get involved += Get Involved Welcome to Fedora! -This guide is intended for people that are interested in learning more about Fedora, perhaps with the intention of contributing to the community. +This guide is intended for people that are interested in learning more about Fedora, perhaps with the intention of getting involved and contributing to the community. + +You can refer to the xref:help.adoc[Getting Help] and xref:communications.adoc[Project Communications] pages for more specific information on how to find assistance via documentation and the various communication channels, such as Ask Fedora, and Fedora Chat (powered by Matrix). == What is Fedora? -The Fedora project is a community of people working together to build a Free and Open Source software platform: link:https://getfedora.org[the Fedora Operating System], and its various editions. -You can learn more about Fedora, our mission, our four foundations, our leadership, our current Communitiy Initiatives, and how we are organised using the pages linked to in the left hand sidebar. +As described under xref:index.adoc[Mission and Foundations], the Fedora Project is a community of people working together to build a Free and Open Source software platform: +the https://getfedora.org[Fedora Operating System], and its various editions. +You can learn more about the Project; our leadership; brand; current Communitiy Initiatives and how we are organised using the pages linked in the left hand sidebar. + If you are looking to contribute and already have an idea of how and what to do, go ahead and get started! If you are not so sure, read on. -== Communication in Fedora +== Contributing to Fedora Fedora is a xref:orgchart.adoc[massive global organisation] where people with many different skills carry out xref:fedora-join::index.adoc[different roles] to keep the community ticking along. -All services used by the Fedora community are linked to a central Fedora account that you can get link:https://accounts.fedoraproject.org/[here]. -We use link:https://chat.fedoraproject.org[Matrix/Element] and/or link:https://fedoraproject.org/wiki/Communicating_and_getting_help?rd=Communicate#IRC[IRC] to speak to each other in real time and link:https://fedoraproject.org/wiki/Communicating_and_getting_help?rd=Communicate#Mailing_Lists[mailing lists] for longer discussions for which short live chats may not be enough. - -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. +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. == Not sure where to start? Come hang out with us! @@ -28,10 +30,8 @@ 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: link:https://lists.fedoraproject.org/admin/lists/fedora-join@lists.fedoraproject.org/[Fedora Join mailing list], -- Chat (over Matrix/Element): link:https://matrix.to/#/%23join:fedoraproject.org?web-instance%5Belement.io%5D%3Dchat.fedoraproject.org[Fedora Join on Matrix/Element], -- Chat (over IRC): link:ircs://irc.libera.chat:6697/%23fedora-join[#fedora-join] on link:https://libera.chat/[Libera.Chat], -- Chat (over Telegram): link:https://t.me/joinfedora[Fedora Join Telegram group]. +- 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], Here, you can speak to community members and other newcomers while we explore Fedora together.