:relatedlinks: [Diátaxis](https://diataxis.fr/)

.. _home:

SRU documentation
=================

.. A single sentence that says what the product is, succinctly and
   memorably.

**Stable release updates** (SRUs) are package updates to a currently supported Ubuntu release.

.. A paragraph of one to three short sentences, that describe what the
   product does.

Once an Ubuntu release has been completed and published, updates for it
are only **released under certain circumstances**, and must follow **a special
procedure** called SRU.

.. A third paragraph of similar length, this time explaining what need the
   product meets.

The SRU principles and processes ensure that stable Ubuntu releases **remain stable
and predictable** to the user.

.. Finally, a paragraph that describes whom the product is useful for.

This documentation is intended for **all Ubuntu users** if
they wish to understand what to expect from Ubuntu stable releases, and
also for **upstream and Ubuntu developers** if they wish to
understand what changes would or would not be acceptable to us. The rest
is intended for **Ubuntu developers and SRU team members** to achieve this
in practice.

.. important::
    Did you **notice a regression** in a package that went to the ``-updates`` pocket?
    Please report this by following :ref:`howto-report-regression`.

---------

In this documentation
---------------------

.. grid:: 2

   .. grid-item-card:: :doc:`How-to guides <howto/index>`
      :columns: 12
      :link: howto/index
      :link-type: doc

      **Step-by-step guides** covering key operations and common tasks

.. grid:: 2
   :reverse:

   .. grid-item-card:: :doc:`Reference <reference/index>`
      :columns: 6
      :link: reference/index
      :link-type: doc

      **Technical information** - specifications, APIs, architecture

   .. grid-item-card:: :doc:`Explanation <explanation/index>`
      :columns: 6
      :link: explanation/index
      :link-type: doc

      **Discussion and clarification** of key topics

---------

Project and community
---------------------

-  `Read our code of
   conduct <https://ubuntu.com/community/ethos/code-of-conduct>`__: As a
   community, we adhere to the Ubuntu code of conduct.

-  `Get
   support <https://askubuntu.com/questions/tagged/stable-release-updates>`__:
   Ask Ubuntu is a question and answer site for Ubuntu users and
   developers.

-  `Join our online
   chat <https://matrix.to/#/#devel:ubuntu.com>`__: Meet us
   in ``#devel:ubuntu.com`` on Matrix.

-  `Report bugs <https://bugs.launchpad.net/sru-docs/+filebug>`__: We
   want to know about the problems, so we can fix them.

-  `Contribute documentation <https://launchpad.net/sru-docs>`__: The documentation sources in Launchpad.

.. toctree::
   :hidden:
   :maxdepth: 2

   howto/index
   explanation/index
   reference/index
   internal