Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/community/contribute/app-development.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,6 @@ Juju charms are deployment and service orchestration scripts that enable people
Since Juju charms can be written in any language, it's a good way for DevOps experts to share deployment and management scripts with the community.
Developers can share their charms on [Charmhub](https://charmhub.io/), a repository of ready-to-use charms.

* Get started by [writing your first Juju charm](https://juju.is/docs/sdk/build-and-deploy-minimal-machine-charm)
* Get started by [writing your first Juju charm](https://documentation.ubuntu.com/ops/latest/tutorial/write-your-first-machine-charm/)


2 changes: 1 addition & 1 deletion docs/community/contribute/art-and-design.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,4 +29,4 @@ Prior to every new release, the community team hosts a wallpaper contest where a
Ubuntu Flavours often have their own distinctive style and rely on volunteers to help design their art assets.
Getting involved with Flavour art design is a great way to connect with the wider Ubuntu ecosystem and share your artistic skills with the entire community.

[Explore the Official Ubuntu Flavours ›](https://ubuntu.com/desktop/flavours)
[Explore the Official Ubuntu Flavours ›](https://ubuntu.com/desktop/flavors)
8 changes: 4 additions & 4 deletions docs/community/contribute/discourse-documentation.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,8 +61,8 @@ Ubuntu has many projects under its umbrella, and this table shows which document

| Published documentation website | Contributing guide | Discourse backend |
|---|---|---|
| [MAAS docs](https://maas.io/docs) | [How to contribute](https://maas.io/docs/contributing-to-maas-documentation) | [Source](https://discourse.maas.io/c/docs/5) |
| [Mir docs](https://mir-server.io/docs) | [How to contribute](https://mir-server.io/docs/how-to-maintain-mir-documentation) | [Source](https://discourse.ubuntu.com/c/mir/docs/28) |
| [MAAS docs](https://canonical.com/maas/docs) | [How to contribute](https://canonical.com/maas/docs/how-to-contribute-to-maas-documentation) | [Source](https://discourse.maas.io/c/docs/5) |
| [Mir docs](https://canonical.com/mir/docs) | [How to contribute](https://canonical.com/mir/docs/how-to-maintain-mir-documentation) | [Source](https://discourse.ubuntu.com/c/documentation/mir-docs/28) |
| [Snap docs](https://snapcraft.io/docs) | [How to contribute](https://snapcraft.io/docs/contribute-to-docs) | [Source](https://forum.snapcraft.io/c/doc/15) |


Expand Down Expand Up @@ -125,7 +125,7 @@ The code that creates the navigation and publishes our documentation from Discou

## Discourse Markdown

Documentation is written in the [Markdown](https://daringfireball.net/projects/markdown/syntax) format [supported by Discourse](https://meta.discourse.org/t/post-format-reference-documentation/19197/2).
Documentation is written in the [Markdown](https://daringfireball.net/projects/markdown/syntax) format [supported by Discourse](https://meta.discourse.org/t/formatting-posts-using-markdown-bbcode-and-html/239348).

Mostly, you don't need to worry about the syntax. If you are unfamiliar with Markdown you can use the style toolbar in the Discourse editing window to mark the elements you need.

Expand Down Expand Up @@ -245,7 +245,7 @@ Discourse Markdown does not support anchor links to a position *within* the same

However, you can use standard HTML within Markdown, which means we can manually add HTML anchor elements that can be linked to.

The [recommended way](https://meta.discourse.org/t/deep-linking-to-headings-anchors/47552) to create anchors is using heading elements with an ID. The ID needs to have `heading--` as a prefix:
The [recommended way](https://meta.discourse.org/t/linking-to-a-heading-within-a-post-or-topic/47552) to create anchors is using heading elements with an ID. The ID needs to have `heading--` as a prefix:

```html
<h3 id='heading--myanchor'>Link to me</h3>
Expand Down
2 changes: 1 addition & 1 deletion docs/community/contribute/documentation.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Our aim is to create and maintain documentation products and practice that repre
We want documentation to be the best it possibly can be.

* Read more about Canonical's [documentation practice](https://canonical.com/documentation)
* Improve your documentation via our [Open Documentation Academy](https://documentationacademy.org/)
* Improve your documentation via our [Open Documentation Academy](https://documentation.academy/)


## Discourse documentation
Expand Down
2 changes: 1 addition & 1 deletion docs/community/contribute/qa-and-testing.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,4 +32,4 @@ Helping test Ubuntu and its numerous Flavors is a fun and easy way to give back

* Join in the testing conversations on the [Ubuntu Testers Telegram channel](https://t.me/UbuntuTesters)

* Test the latest Ubuntu builds on the [Testing Tracker](http://iso.qa.ubuntu.com/)
* Test the latest Ubuntu builds on the [Testing Tracker](https://iso.qa.ubuntu.com/)
10 changes: 5 additions & 5 deletions docs/community/ethos/code-of-conduct.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Our work will be used by other people, and we in turn will depend on the work of

### Be respectful

Disagreement is no excuse for poor manners. We work together to resolve conflict, assume good intentions and do our best to act in an empathic fashion. We dont allow frustration to turn into a personal attack. A community where people feel uncomfortable or threatened is not a productive one.
Disagreement is no excuse for poor manners. We work together to resolve conflict, assume good intentions and do our best to act in an empathic fashion. We don't allow frustration to turn into a personal attack. A community where people feel uncomfortable or threatened is not a productive one.

### Take responsibility for our words and our actions

Expand Down Expand Up @@ -47,7 +47,7 @@ We all lead by example, in debate and in action. We encourage new participants t

### Delegation from the top

Responsibility for the project starts with the benevolent dictator, who delegates specific responsibilities and the corresponding authority to a series of teams, councils and individuals, starting with the Community Council (“CC”). That Council or its delegated representative will arbitrate in any dispute.
Responsibility for the project starts with the "benevolent dictator", who delegates specific responsibilities and the corresponding authority to a series of teams, councils and individuals, starting with the Community Council ("CC"). That Council or its delegated representative will arbitrate in any dispute.

We are a meritocracy; we delegate decision making, governance and leadership from senior bodies to the most able and engaged candidates.

Expand All @@ -71,9 +71,9 @@ We invite anybody, from any company, to participate in any aspect of the project

### Teamwork

A leaders foremost goal is the success of the team.
A leader's foremost goal is the success of the team.

A virtuoso is judged by their actions; a leader is judged by the actions of their team. A leader knows when to act and when to step back. They know when to delegate work, and when to take it upon themselves.
"A virtuoso is judged by their actions; a leader is judged by the actions of their team." A leader knows when to act and when to step back. They know when to delegate work, and when to take it upon themselves.

### Credit

Expand All @@ -93,7 +93,7 @@ This Code is not exhaustive or complete. It is not a rulebook; it serves to dist

## Taking Conflict to the Community Council

If a member of the community feels there has been a violation of the Ubuntu Code of Conduct, they are encouraged to bring it forward to the Community Council for review. For additional information on this process, please visit [Conflict Resolution](https://ubuntu.com/community/governance/conflict-resolution).
If a member of the community feels there has been a violation of the Ubuntu Code of Conduct, they are encouraged to bring it forward to the Community Council for review. For additional information on this process, please visit {ref}`conflict-resolution`.

```{note}
The Ubuntu Code of Conduct is licensed under the [Creative Commons Attribution-Share Alike 3.0 license](https://creativecommons.org/licenses/by-sa/3.0/). You may re-use it for your own project, and modify it as you wish, just please allow others to use your modifications and give credit to the Ubuntu Project!
Expand Down
6 changes: 3 additions & 3 deletions docs/community/ethos/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,16 +16,16 @@ Ubuntu is more than just a name. It embodies the very essence of our community.

Members of the Ubuntu Community follow a simple code of conduct that helps ensure our community stays healthy, stable and remains a place for collaboration and prosperity. For those wanting to join in our efforts, it is crucial to learn and embody these important principles.

{ref}`Read the Ubuntu Code of Conduct <code-of-conduct>`
{ref}`Read the Ubuntu Code of Conduct > <code-of-conduct>`

## Diversity Policy

Our community gains strength from its diversity and actively encourages everyone to participate in the project. We are committed to fostering a community that everyone feels proud to be a part of and one that is built around a mutual respect for one another.

{ref}`Discover how we support and honor our diversity <diversity>`
{ref}`Discover how we support and honor our diversity > <diversity>`

## Our Mission

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. It is through the great equalizing quality of open source that we seek to spread the spirit of Ubuntu around the world.

{ref}`Learn the guiding tenets of the Ubuntu Mission <mission>`
{ref}`Learn the guiding tenets of the Ubuntu Mission > <mission>`
14 changes: 7 additions & 7 deletions docs/community/ethos/mission.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,19 +11,19 @@ We believe that every computer user:
- Should have the freedom to download, run, copy, distribute, study, share, change and improve their software for any purpose, without paying licensing fees.
- Should be able to use their software in the language of their choice.
- Should be able to use all software regardless of disability.
- Our philosophy is reflected in the software we produce, the way we distribute it and our licensing terms, too - [Intellectual property rights policy](https://ubuntu.com/legal/intellectual-property-policy).
- Our philosophy is reflected in the software we produce, the way we distribute it and our licensing terms, too - [Intellectual property rights policy](https://canonical.com/legal/intellectual-property-policy).

We aim to be the platform which leads in achieving these ideals. We work to the goal that every piece of software you could possibly need is available under a license that gives you those freedoms.

## To accelerate innovation and underpin operations

We make the world better by enabling anyone, anywhere, to pursue their ambitions regardless of their resources. It is important to us that a researcher in the furthest corner of the world from Silicon Valley can use Ubuntu on exactly the same terms as a startup in San Francisco, to build something that nobody has imagined before. Its also important to us that Ubuntu enables those upstarts to grow, from garage visionaries to galactic stars, and Canonical serves to provide enterprise capabilities and services for Ubuntu users.
We make the world better by enabling anyone, anywhere, to pursue their ambitions regardless of their resources. It is important to us that a researcher in the furthest corner of the world from Silicon Valley can use Ubuntu on exactly the same terms as a startup in San Francisco, to build something that nobody has imagined before. It's also important to us that Ubuntu enables those upstarts to grow, from garage visionaries to galactic stars, and Canonical serves to provide enterprise capabilities and services for Ubuntu users.

## Free software

Our preferred software licenses are free software and always will be. Free software gives everyone the freedom to use it however they want and share with whoever they like. This freedom has huge benefits. At one end of the spectrum it enables the Ubuntu community to grow and share its collective experience and expertise to continually improve all things Ubuntu. At the other, we are able to give access to essential software for those who couldnt otherwise afford it – an advantage thats keenly felt by individuals and organizations all over the world.
Our preferred software licenses are 'free software' and always will be. Free software gives everyone the freedom to use it however they want and share with whoever they like. This freedom has huge benefits. At one end of the spectrum it enables the Ubuntu community to grow and share its collective experience and expertise to continually improve all things Ubuntu. At the other, we are able to give access to essential software for those who couldn't otherwise afford it – an advantage that's keenly felt by individuals and organizations all over the world.

Quoting the [Free Software Foundations](https://www.fsf.org/), [What is Free Software](https://www.gnu.org/philosophy/free-sw.html), the freedoms at the core of free software are defined as:
Quoting the [Free Software Foundation's](https://www.fsf.org/), ['What is Free Software'](https://www.gnu.org/philosophy/free-sw.html), the freedoms at the core of free software are defined as:

- The freedom to run the program, for any purpose.
- The freedom to study how the program works and adapt it to your needs.
Expand All @@ -34,15 +34,15 @@ Quoting the [Free Software Foundation’s](https://www.fsf.org/), [‘What is Fr

Open source is collective power in action. The power of a worldwide community of highly skilled experts that build, share and improve the very latest software together - then make it available to everyone.

The term open source was coined in 1998 to remove the ambiguity in the English word free and it continues to enjoy growing success and wide recognition. Although some people regard free and open source as competing movements with different ends, we do not. Ubuntu proudly includes members who identify with both.
The term open source was coined in 1998 to remove the ambiguity in the English word 'free' and it continues to enjoy growing success and wide recognition. Although some people regard 'free' and 'open source' as competing movements with different ends, we do not. Ubuntu proudly includes members who identify with both.

Originally coined in 1998, the term open source came out of the free software movement, a collaborative force going strong since the dawn of computing in the 1950s. This early community was responsible for the development of many of the first operating systems, software and, in 1969, the Internet itself.

The open-source community is thriving and today boasts some of the best brains in the business. The aim has not changed: free systems and software should be available to everybody, wherever they are.

Without open source, many of the systems and applications we take for granted simply would not exist. All the big players in computing come from, or owe a huge creative debt to, the open-source community, and continue to rely on its talent and expertise when developing new products.

In the spirit of open source, Ubuntu is absolutely free to download, use, share and improve. Please note, however, that the Ubuntu name and logo are protected trademarks, subject to our [intellectual property rights policy](https://ubuntu.com/legal/intellectual-property-policy).
In the spirit of open source, Ubuntu is absolutely free to download, use, share and improve. Please note, however, that the Ubuntu name and logo are protected trademarks, subject to our [intellectual property rights policy](https://canonical.com/legal/intellectual-property-policy).

## What is open source?

Expand All @@ -59,4 +59,4 @@ There are 10 core principles of open-source software:
1. The license must not restrict other software.
1. The license must be technology-neutral.

[Take a look at the Open Source Initiatives definition of open-source software for a more detailed explanation](https://opensource.org/osd).
[Take a look at the Open Source Initiative's definition of open-source software for a more detailed explanation](https://opensource.org/osd).
4 changes: 2 additions & 2 deletions docs/community/governance/canonical.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,10 @@

## As the company behind the Ubuntu Project, Canonical knows Ubuntu inside out

Ubuntu is produced by Canonical and friends. We run Ubuntu as an open project to enable others with diverse ideas to benefit from all the work we do to deliver the worlds best open platform. As a result, Ubuntu is far bigger and more interesting than anything a single company could produce.
Ubuntu is produced by Canonical and friends. We run Ubuntu as an open project to enable others with diverse ideas to benefit from all the work we do to deliver the world's best open platform. As a result, Ubuntu is far bigger and more interesting than anything a single company could produce.

Still, Canonical is responsible for delivering six-monthly milestone releases and regular LTS releases for enterprise production use, as well as security updates, support and the entire online infrastructure for community interaction. Enterprises count on Canonical to support, secure and manage Ubuntu infrastructure and devices.

With more than 1200 employees in over 80 countries, the company underpins the critical infrastructure for thousands of businesses and millions of Ubuntu users around the world.

Find out more on [the Canonical website](https://www.canonical.com/).
Find out more on [the Canonical website](https://canonical.com/).
2 changes: 1 addition & 1 deletion docs/community/governance/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,5 +84,5 @@ 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 [Ubuntu Local Communities](https://ubuntu.com/community/locos).
To join a Local Community team or learn how to start one in your area, check out {ref}`Ubuntu Local Communities <local-communities>`.

2 changes: 1 addition & 1 deletion docs/community/governance/ubuntu-teams.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ Below is a list of key teams that operate within the Ubuntu project and their re
| Team name | Responsibility |
| --- | --- |
| [IRC team](https://wiki.ubuntu.com/IRC/IrcTeam) | Management of the Ubuntu IRC channels on Libera.chat |
| [Forums team](https://launchpad.net/~ubuntuforums-staff) | Management of ubuntuforums.org |
| [Forums team](https://launchpad.net/~ubuntuforums-staff) | Management of `ubuntuforums.org` |
| [Ubuntu News team](https://wiki.ubuntu.com/NewsTeam) | Gather and publish news on Ubuntu-related stories, and Posting to the Fridge and UWN |


Expand Down
2 changes: 1 addition & 1 deletion docs/community/local/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ With the incredible success of Ubuntu around the world, the Ubuntu Local Communi

## How to join an Ubuntu Local Community

Becoming part of an Ubuntu Local Community is a great way to meet other passionate Ubuntu enthusiasts in your community. Find a team in your area to join by checking out the [Ubuntu Local Community Teams](https://ubuntu.com/community/locos/join) Directory.
Becoming part of an Ubuntu Local Community is a great way to meet other passionate Ubuntu enthusiasts in your community. Find a team in your area to join by checking out the [Ubuntu Local Community Teams](https://ubuntu.com/community/local-communities#join-community) Directory.


## How to create an Ubuntu Local Community
Expand Down
Loading