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

Tutorial

Get started contributing to Ubuntu

  • Build and upload:

    • a deb package

    • a Snap

    • a container image

  • Work on documentation

Tutorial
How-to guides

Step-by-step guides for key tasks, use-cases and problems

These guides assume basic familiarity with Ubuntu and its processes

How-to guides
Reference

Technical information about:

  • APIs

  • Commands

  • Internals and architecture

  • Specifications

Reference
Explanation

Explanation of key topics and concepts

These discussions provide clarification, background information and context

Explanation

  • Governance: Community Council | Technical Board | Delegation and Teams | Canonical | Debian

  • Community: Communication | Membership | Code of Conduct | Diversity | Mission

  • Process: Main Inclusion Review | Stable Release Updates | Sponsorship | Releases

  • Development: Packaging Guide | Developer Guide | Archive Administration | git-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.