Ubuntu Wiki:About

The Ubuntu wiki is a place to share and maintain content of general interest to Ubuntu users.

Identity

The wiki is made for the community by the community. The Ubuntu community is diverse and the wiki should have something for everyone.

Note on usage of wiki for internal documentation

Canonical teams should not use this wiki for internal team documentation unless they believe it is of interest to the community and are open to contributions from the community.

Relationship to Ubuntu docs

The wiki complements Ubuntu's official documentation, which is developed more cautiously under the stewardship of dedicated engineering teams who have a professional responsibility to maintain the documentation as part of a product.

In comparison, it is much easier to make an edit or create a page on the wiki. This means it can be used to generate and connect ideas quickly on a wide range of topics relevant to the Ubuntu community.

How the wiki is built

It's built using MediaWiki, the same wiki engine used by Wikipedia and also other Linux wikis, including Arch and Fedora.

The MediaWiki instance is deployed as a charm. The skin is a customized version of the Vector 2022 skin.

The wiki is hosted on Canonical infrastructure as a service to the Ubuntu community.

Content

For the wiki to grow, we need you to make edits and create pages.

Types of content

A page submitted to the wiki should meet the following criteria:

1. It is interesting or useful to the Ubuntu community
2. It does not duplicate information that is easy to find elsewhere

Given this is a wiki about a Linux distribution, there will be a lot of technical content; however, your contribution doesn't need to be technical. For some examples of non-technical content, look at the history category.

Missing pages

If you think a page is missing, you should create the page, assuming you have the necessary permissions.

If a page from the old wiki is missing then you should migrate the page from the archives.

All of the information from both of the old wikis is archived publicly on GitHub.

Reporting bugs

You may find bugs or issues with the wiki when using it as a reader, editor, or administrator.

Using Discourse

Please send reports to the Communications Council on the Ubuntu community Discourse.

There are two ways of sending the report. Make sure you are logged in, then either:

• Send a DM with @comms-council as the recipient, or
• Go to discourse.ubuntu.com/g/comms-council and post a message.

Contributing to the code

The code for the wiki is spread across several GitHub repositories.

If you are comfortable with GitHub, issues, and Pull Requests, you are welcome to contribute directly.

Repositories

• Wiki skin: github.com/ubuntu/ubuntu-mediawiki-extension
• Wiki charm: github.com/canonical/mediawiki-k8s-operator