Merge pull request #255 from s-makin/final-community-docs-add

Final community docs add

Author: s-makin

docs/.custom_wordlist.txt

@@ -67,10 +67,12 @@ Quokka
 radeon
 rasdaemon
 retracer
+Rockcraft
 Schooltool
 schroot
 sosreport
 SRUs
+Starcraft
 subiquity
 Tegra
 Toolchain

docs/community/community-support.md

@@ -0,0 +1,54 @@
+(community-support)=
+# Community support
+
+The Ubuntu Community provides a number of resources to help support new and experienced users, provide spaces for discussion, and help troubleshoot common technical issues.
+
+
+## Official documentation
+
+The Ubuntu Documentation Team provides official support guides for Ubuntu and the many projects within its ecosystem. Official Documentation is provided in a number of formats and languages.
+
+[Read official Ubuntu Documentation >](https://docs.ubuntu.com/)
+
+
+## Chat and discussion
+
+### Matrix chat
+
+Matrix is an instant messaging (IM) platform where you can talk to Ubuntu community members and developers in an open setting. Many Ubuntu projects have public rooms where you can ask for help. You can see all our public rooms in {matrix}`the Ubuntu Space <community>`. We also have a dedicated room for support.
+
+{matrix}`Join the Ubuntu Support room on Matrix > <support>`
+
+If you're new to Matrix, you can create an account by following the {ref}`Getting started with Matrix guide <matrix-onboarding>`.
+
+
+### IRC chat
+
+Internet Relay Chat (IRC) allows real-time text messaging and is arranged in a series of rooms or channels. Each channel has a particular topic where members can communicate with one another in an open setting. If you have a question or need assistance, the Ubuntu Community has a number of IRC channels you can join.
+
+Visit the [IRC Channel List](https://wiki.ubuntu.com/IRC/ChannelList) for a catalog of the Ubuntu Community channels.
+
+If you’ve never used IRC before, check out the [IRC Introduction](https://help.ubuntu.com/community/InternetRelayChat).
+
+
+## Technical support
+
+### AskUbuntu
+
+AskUbuntu is a collaboratively-edited question-and-answer site for Ubuntu users and developers. Users seeking assistance can ask and update questions along with rating the quality of the answers they receieve. Please note this site is English only.
+
+[Start asking questions at AskUbuntu >](https://askubuntu.com/)
+
+
+### Ubuntu Discourse
+
+The Ubuntu Discourse (also referred to as the Ubuntu Community Hub) is a collaborative space where the community can discuss topics around Ubuntu and the many projects that make up its ecosystem. Users in search of technical support can make an account on the platform and seek help from their fellow community members.
+
+[Find support and help on the Ubuntu Discourse >](https://discourse.ubuntu.com/t/welcome-to-support-and-help/49951)
+
+
+## Ubuntu mailing lists
+
+Within the Ubuntu ecosystem, mailing lists are used to share information and act as a means of group communication over email. There are lists for general announcements, Ubuntu development, community discussion and many others. Some lists are announcement-only while others allow for open discussion.
+
+[Explore subscriptions to the Ubuntu mailing lists >](https://lists.ubuntu.com/)

docs/community/contribute/contribute.md docs/community/contribute/index.mddocs/community/contribute/contribute.md renamed to docs/community/contribute/index.md

@@ -1,13 +1,14 @@
 (project-governance)=
 # Project governance
 
+
 ```{toctree}
 :maxdepth: 1
 :hidden:
 
+../ethos/index
 canonical
 debian
-ubuntu-teams
 delegation
 ```
 
@@ -85,4 +86,3 @@ A major part of the fabric of the community is the Local Community (LoCo) team s
 Local Community teams are a great way to gather free software lovers together for beer, open discussion, talks, marketing events and to recognise the achievements of local free software contributors. LoCo teams are provided with spaces for discussion, collaboration and event planning on the [Ubuntu Discourse](https://discourse.ubuntu.com/c/locos/129).
 
 To join a Local Community team or learn how to start one in your area, check out {ref}`Ubuntu Local Communities <local-communities>`.
-

docs/community/governance/index.md

@@ -1,12 +1,50 @@
-(community-governance)=
-# Community and governance
-
+(ubuntu-community)=
+# The Ubuntu Community
 
 ```{toctree}
 :maxdepth: 1
+:hidden:
 
-ethos/index
-governance/index
+community-support
 how-ubuntu-is-made/matrix/index
-contribute/contribute
+contribute/index
 ```
+
+We are an international community with a mission to bring free software to the widest possible audience. Our name "Ubuntu" means "humanity towards others". We embody this by welcoming anyone in our community and sharing our work freely. With millions of users and thousands of contributors all over the world, we help shape the future of computing.
+
+Welcome! Whether you're an (aspiring) artist, writer, software developer, or systems administrator, there are lots of ways to get involved! We would be thrilled to have a chat and guide you through this beautiful and inspiring community.
+
+## Participate
+
+There are many ways you can participate in the Ubuntu community. If you can think of it, it might just be what we need. You can choose the level and interests that works for you.
+
+* We invite all who use and contribute to Ubuntu and its numerous related projects to share their thoughts and help shape its future. [Join in the conversation on the Ubuntu Discourse](https://discourse.ubuntu.com/).
+* Take part in live communication with fellow community members in collaborative, interest-based rooms and spaces. {ref}`Chat with our community on Matrix <matrix-index>`.
+* Our worldwide community is strengthened by a network of regional teams that advocate for the community and its mission. {ref}`Find a Local Community near you <local-communities>`.
+* Share your technical know-how with others by answering questions on [Ask Ubuntu](https://askubuntu.com/), or the [Ubuntu Discourse](https://discourse.ubuntu.com/).
+* Those who demonstrate sustained contributions to our community have opportunities for recognition and leadership roles. {ref}`Learn about Ubuntu Membership <ubuntu-membership>` and our {ref}`councils and teams <who-makes-ubuntu>`.
+
+Our project is large and diverse just like the community that empowers it. We rely on individuals with different skills, both technical and non, to build Ubuntu and its many components. We invite you to help shape Ubuntu to better meet your needs. {ref}`Discover the many ways that you can contribute to Ubuntu <contribute-to-ubuntu>`.
+
+
+## Learn more
+
+To better understand how our large umbrella of communities operates, take a look at these resources.
+
+* Members of the Ubuntu Community follow a simple set of core principles that help ensure our community stays healthy, stable and remains a place for collaboration and prosperity. {ref}`Read the Ubuntu Code of Conduct <code-of-conduct>`.
+* The mission for Ubuntu is both social and economic. We believe that bringing free software to the widest audience will empower individuals and communities to innovate, experiment and grow. {ref}`Learn the guiding tenets of the Ubuntu Mission <mission>`.
+* Ubuntu, like other large communities, requires leadership and direction to help ensure its sustainability and longevity. Learning how all the interconnected bodies work together is important to understanding the Ubuntu way. {ref}`Learn how they all work together to sustain our community <community-council>`.
+* Keep up to date with all the latest news and happenings from around the community with [The Ubuntu Weekly Newsletter](https://discourse.ubuntu.com/c/uwn/124) and the [Ubuntu Blog](https://ubuntu.com/blog).
+
+
+## Get help
+
+Are you instead stuck and need help? [Take a look at how our community can support you.](https://ubuntu.com/community/support)
+
+
+## Discover
+
+Take a look at our Ubuntu Summit 2022 {spellexception}`Aftermovie` to get a sense of the atmosphere of our community.
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/8XF6jR7XzXM?si=jjFRsggKZHIVOiNN" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
+

docs/community/index.md

@@ -10,12 +10,12 @@ Below is a list of key teams that operate within the Ubuntu project and their re
 | Team name | Responsibility |
 | --- | --- |
 | [Desktop team](https://wiki.ubuntu.com/DesktopTeam) | Handle all the packages that go into the Ubuntu desktop installation |
-| [HPC team](https://ubuntu.com/community/governance/teams/hpc) | The Ubuntu High-Performance Computing (HPC) team aims to provide the highest quality HPC infrastructure, applications, and user experience for the Ubuntu ecosystem |
+| [HPC team](https://ubuntu.com/community/docs/governance/teams/hpc) | The Ubuntu High-Performance Computing (HPC) team aims to provide the highest quality HPC infrastructure, applications, and user experience for the Ubuntu ecosystem |
 | [Kernel team](https://wiki.ubuntu.com/KernelTeam) | Maintain the Linux kernel in Ubuntu |
 | [Foundations team](https://wiki.ubuntu.com/FoundationsTeam) | Deliver the core Ubuntu system, common to the whole Ubuntu family of products and services, i.e. plumbing |
 | [QA team](https://wiki.ubuntu.com/QATeam) | Develop tools, policies, and practices for ensuring Ubuntu's quality as a distribution as well as providing general advice, oversight, and leadership of QA activities within the Ubuntu project |
 | {ref}`release-team` | The Release Team helps bring together all the essential building blocks for every Ubuntu release |
-| [Rocks community](https://ubuntu.com/community/governance/teams/rocks) | The Rocks Community is your hub for exploring Ubuntu Rocks and everything "containers" |
+| [Rocks community](https://ubuntu.com/community/docs/governance/teams/rocks) | The Rocks Community is your hub for exploring Ubuntu Rocks and everything "containers" |
 | [Security team](https://wiki.ubuntu.com/SecurityTeam) | Keep Ubuntu and its users secure through fixing vulnerabilities and contributing to its security development |
 | [Server team](https://wiki.ubuntu.com/ServerTeam) | Deliver the best operating system for the cloud and scale-out computing |
 | [Ubuntu Flutter community](https://github.com/ubuntu-flutter-community) | Design and implementation of the Flutter visuals, a whole additional set of widgets specifically designed for the Ubuntu desktop, Flutter "Yaru" theme for the Ubuntu visuals in Flutter apps, a dedicated Flutter icon theme and the new snap-store front-end, plus many more apps in development |

docs/community/governance/ubuntu-teams.md docs/community/teams/ubuntu-teams.mddocs/community/governance/ubuntu-teams.md renamed to docs/community/teams/ubuntu-teams.md

@@ -4,21 +4,27 @@
 
 ## Community
 
-How the project is governed. This sets out the expectations for contributors
-and maintainers alike.
+All about the Ubuntu Community, its support structures, and communication channels.
 
 ```{toctree}
 :maxdepth: 1
 
 /community/index
 ```
 
+## Project governance
+
+How the project is governed. This sets out the expectations for contributors and maintainers alike.
+
+```{toctree}
+:maxdepth: 1
+
+/community/governance/index
+```
+
 ## Concepts
 
-Definitions of key terms, outlines of important concepts. These should be well
-linked to other sections, but should primarily be for contributors (especially
-newer contributors) to understand the various concepts and how they fit into
-the processes.
+Definitions of key terms and outlines of important concepts. These are primarily for contributors (especially newer contributors) to understand the various concepts and how they fit into the processes that make up Ubuntu Development.
 
 ```{toctree}
 :maxdepth: 1
@@ -28,9 +34,7 @@ concepts/index
 
 ## Process overviews
 
-High level overviews of the various processes involved in making Ubuntu.
-Every process should have (and be linked to) a corresponding set of steps,
-either for contributors or maintainers, depending on the process.
+High level overviews of the various processes involved in making Ubuntu. Every process should have (and be linked to) a corresponding set of steps, either for contributors or maintainers, depending on the process.
 
 ```{toctree}
 :maxdepth: 1

docs/how-ubuntu-is-made/index.md

@@ -42,9 +42,9 @@ staging/release-team/releases/ release-team/list-of-releases/
 staging/package-archive/ how-ubuntu-is-made/concepts/package-archive/
 
 # Governance/community pages
-explanation/governance/ community/governance/
-how-ubuntu-is-made/index-governance/ community/governance/
-how-ubuntu-is-made/governance/ community/governance/
+explanation/governance/ community/
+how-ubuntu-is-made/index-governance/ community/
+how-ubuntu-is-made/governance/ community/
 
 reference/governance/ethos/ community/ethos/
 how-ubuntu-is-made/governance/ethos/ community/ethos/
@@ -127,7 +127,7 @@ contributors/bug-triage/assign-bug-to-package/ contributors/bug-triage/assign-a-
 contributors/debugging/debug-apport-crash/ contributors/debugging/debug-an-apport-crash/
 contributors/new-package/create-new-package/ contributors/new-package/create-a-new-package/
 contributors/new-package/request-sru/ contributors/new-package/request-an-sru/
-contributors/new-package/upload-packages-to-ppa/ contributors/new-package/upload-packages-to-a-ppa//
+contributors/new-package/upload-packages-to-ppa/ contributors/new-package/upload-packages-to-a-ppa/
 contributors/patching/committing-changes/ contributors/patching/commit-changes/
 contributors/patching/make-changes-to-package/ contributors/patching/make-changes-to-a-package/
 contributors/patching/merge-proposal/ contributors/patching/submit-a-merge-proposal/
@@ -137,6 +137,10 @@ contributors/setup/get-package-source/ contributors/setup/get-the-source-of-a-pa
 contributors/setup/setup/ contributors/setup/set-up-for-ubuntu-development/
 contributors/merging/submit-merge-proposal/ contributors/merging/git-ubuntu-merge-proposal/
 
+community/contribute/contribute/ community/contribute/
+community/governance/ubuntu-teams/ community/teams/ubuntu-teams/
+
 SRU/index SRU/stable-release-updates/
 SRU/explanation/ SRU/
 how-ubuntu-is-made/processes/stable-release-updates/ SRU/stable-release-updates/
+

docs/redirects.txt

@@ -47,6 +47,15 @@ About Ubuntu Membership, the benefits and responsibilities, and how to become an
 ```
 
 
+## Ubuntu teams
+
+```{toctree}
+:maxdepth: 1
+
+/community/teams/ubuntu-teams
+```
+
+
 ## Specialist teams
 
 For specific, specialist teams on Launchpad.