=================
Sign an agreement
=================

This tutorial is for contributors. A repository asks you to sign agreements
before your pull request is accepted, for example its AI policy. Signing takes
a minute and is done once for each version of an agreement, for all
repositories that ask for it.

1. Open your pull request on GitHub. In the checks, each agreement has an entry
   such as ``sign.pycal.org/ai-policy — @you: please sign AI Policy``. Select
   **Details**.
2. The page lists the agreements of the pull request. Select the agreement.
3. Select **Sign in with GitHub**. GitHub asks you to authorize the app. The app
   learns your handle; it can not act on your repositories.
4. Read the agreement. If you signed an earlier version, the page shows what
   changed since then, line by line.
5. Tick **I have read and accept this agreement**, type your GitHub handle and
   select **Sign the agreement**.

The labels of your open pull requests and their checks are updated at once.
New pull requests are labelled when they are opened.

What you signed is listed on the page **My agreements**.

Why you type your handle and why there is no other way to sign is explained in
:doc:`/explanation/signing`.

When signing fails, the page names the error and links to its description in
:doc:`/reference/errors`.