Ubuntu project documentation

Work in progress

Welcome to the Ubuntu Project documentation! Read more about this project.

This documentation is currently under construction. We have added placeholders to help guide the structure. This means many pages will be initially empty. Pages may also move around or become split (or combined) as we work with the source material.

You can keep track of the progress via our fortnightly Discourse updates in this thread.

Contributions are very welcome! See our issues list for ideas, and our contributing guide for details on how to contribute.

Ubuntu is the world’s most widely deployed Linux operating system, but it’s also a long-standing software project, a community, and a mesh of distributed processes and governance that enable its contributors to deliver the world-class experience we’ve come to know and love.

Ubuntu has always been a very openly governed community. This open governance means that we have some community organized and run decision-making groups that help us to lead and make decisions about different elements of Ubuntu.

There are many ways to contribute to Ubuntu - be that packaging of core pieces of the operating system, writing applications for the Desktop, providing translations, working on documentation, designing wallpapers, QA, and more. This documentation will outline those contributor journeys, and the processes that govern them.


In this documentation

Everything you need to understand what Ubuntu is and how it’s made

  • Project Governance

  • Mission, CoC, diversity policy

  • Peers (Debian and Canonical)

  • Key concepts

  • Process overviews

How Ubuntu is made

Guides to help you build and contribute to Ubuntu

  • Fix bugs

  • Find a sponsor for your upload

  • Update a package version

  • Templates and checklists

  • Contribute documentation

Guides for contributors

Guides for tasks that require elevated permissions

  • Review an MIR or SRU

  • Sponsor an upload

  • Archive management

  • Manage a release

  • Process checklists

Guides for maintainers

About the people of Ubuntu, their roles, and their responsibilities

  • Councils and Boards

  • Delegation

  • Roles (uploader, core-dev etc)

  • Joining a role (contributor pathways)

  • Community

Who makes Ubuntu

Project and community

The Ubuntu Linux distribution is part of the Ubuntu family of projects. It’s an open source project that warmly welcomes community projects, contributions, suggestions, fixes, and constructive feedback.

Using Ubuntu

  • Ubuntu Server documentation

  • Ubuntu Desktop documentation

  • Ubuntu Core documentation

  • Ubuntu on Public Cloud

  • Ubuntu for Developers