Add explanation docs on Sponsorship

change to british spelling; removed broken link
canonical · Nov 1, 2024 · ef84709 · ef84709
1 parent d6b22fb
commit ef84709
Show file tree

Hide file tree

Showing 5 changed files with 66 additions and 4 deletions.
diff --git a/docs/explanation/_index.rst b/docs/explanation/_index.rst
@@ -16,7 +16,7 @@ knowledge and become better at packaging and development.
    releases
    archive
    launchpad
-   sponsoring
+   sponsorship
    proposed-migrations
    stable-release-updates
    debian-merges-and-syncs

diff --git a/docs/explanation/archive.rst b/docs/explanation/archive.rst
@@ -306,7 +306,7 @@ Ubuntu encourages contributions from any person in the wider community.
 However, direct uploading to the Ubuntu package archive is restricted. These
 general contributions need to be reviewed and uploaded by a :term:`sponsor <Sponsor>`.
 
-See our :doc:`article on sponsoring </explanation/sponsoring>` that explains this
+See our :doc:`article on sponsorship </explanation/sponsorship>` that explains this
 process in more detail.
 
 Security update propagation

diff --git a/docs/explanation/sponsoring.rst b/docs/explanation/sponsoring.rst
diff --git a/docs/explanation/sponsorship.rst b/docs/explanation/sponsorship.rst
@@ -0,0 +1,54 @@
+Sponsorship
+===========
+
+Sponsorship is a process that allows developers without upload rights to submit their patches or new packages for review. If approved, an authorised developer will upload the changes on their behalf.
+
+When can you request sponsorship?
+---------------------------------
+
+Since upload rights are carefully managed to ensure system stability and security, new contributors usually don't have them. So if you don't have upload rights, you can request sponsorship in the following situations:
+
+- Making changes to existing packages or incremental updates.
+- Submitting security updates or bug fixes.
+- Introducing new packages to Ubuntu.
+
+Requesting sponsorship
+----------------------
+
+To request sponsorship, follow these steps:
+
+1. `File an Ubuntu bug in Launchpad <https://bugs.launchpad.net/ubuntu/+filebug>`_ or follow up on an existing one.
+#. Add the necessary files, such as patches or ``.diff.gz`` files, according to the package's requirements. If the change is a patch, follow the patch tagging guidelines. For security updates, follow the security update packaging guidelines see `Packaging <https://wiki.ubuntu.com/SecurityTeam/UpdatePreparation#Packaging>`_.
+
+#. Link your changes to the bug. See `SeekingSponsorship <https://wiki.ubuntu.com/DistributedDevelopment/Documentation/SeekingSponsorship>`_.
+#. Subscribe ``ubuntu-sponsors`` or ``ubuntu-security-sponsors`` to the bug.
+
+Sponsoring a patch
+------------------
+
+Members of the :term:`Ubuntu Sponsors` and :term:`Ubuntu Security Sponsors` teams have the right to sponsor patches or new packages. So if you are interested in sponsoring, you can apply to join these teams.
+
+Responding to feedback from sponsors
+------------------------------------
+
+If a sponsor reviews your changes and requests further modifications, make the modifications to the branch you were working on, then commit them by running:
+
+.. code-block:: none
+
+    $ bzr commit
+
+Now, push your modifications to :term:`Launchpad`. Since ``bzr`` remembers the previous push location, you can simply run:
+
+.. code-block:: none
+
+    $ bzr push
+
+After pushing your modifications, reply to the sponsor's request explaining the modifications you made and request a re-review. You can also respond directly on the merge proposal page in Launchpad.
+
+Resources
+---------
+
+- `SponsorshipProcess <https://wiki.ubuntu.com/SponsorshipProcess>`_
+- `SeekingSponsorship <https://wiki.ubuntu.com/DistributedDevelopment/Documentation/SeekingSponsorship>`_
+- `UpdatePreparation <https://wiki.ubuntu.com/SecurityTeam/UpdatePreparation#Packaging>`_
+- `Seeking Review and Sponsorship <https://ubuntu-packaging-guide.readthedocs.io/en/latest/ubuntu-packaging-guide/udd-sponsorship.html>`_
diff --git a/docs/reference/glossary.rst b/docs/reference/glossary.rst
@@ -1326,6 +1326,16 @@ Glossary
 
         See also: `Ubuntu SRU Team <https://wiki.ubuntu.com/StableReleaseUpdates#Contacting_the_SRU_team>`_
 
+    Ubuntu Sponsors
+        *Work in Progress*
+
+        See also: `Ubuntu Sponsors <https://launchpad.net/~ubuntu-sponsors>`_
+
+    Ubuntu Security Sponsors
+        *Work in Progress*
+
+        See also: `Ubuntu Security Sponsors Team <https://launchpad.net/~ubuntu-security-sponsors>`_
+
     Ubuntu Stable Release
         The Ubuntu stable release is the officially published version of Ubuntu and
         its set of :term:`packages <Package>`.