Skip to content

Commit a71d970

Browse files
committed
Why do I need to sign the CLA again?
1 parent 3029299 commit a71d970

File tree

1 file changed

+35
-1
lines changed

1 file changed

+35
-1
lines changed

getting-started/pull-request-lifecycle.rst

Lines changed: 35 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -368,6 +368,40 @@ Here are the steps needed in order to sign the CLA:
368368
.. _contributor form: https://www.python.org/psf/contrib/contrib-form/
369369
.. _Python Software Foundation: https://www.python.org/psf-landing/
370370

371+
Why do I need to sign the CLA again?
372+
------------------------------------
373+
374+
Sometimes the CLA bot asks you to sign the CLA for a backport PR,
375+
when you've already signed it for the original PR.
376+
This is because you need to sign the CLA for all the email addresses you commit
377+
with.
378+
379+
This can happen when you've `configured your Git client
380+
<https://docs.github.com/en/account-and-profile/how-tos/email-preferences/setting-your-commit-email-address>`__
381+
with one email address, and signed the CLA with this, but have
382+
`configured your GitHub account <https://github.com/settings/emails>`__
383+
with another primary email
384+
(often this is the private ``id+username@users.noreply.github.com`` address).
385+
386+
1. In the original PR, the CLA bot verifies all the emails in the commits have
387+
signed the CLA.
388+
389+
2. We then squash merge the PR, which creates a single new commit using the
390+
author's primary email. This can be different from the one you originally
391+
committed with.
392+
393+
3. Backports often only have this new single commit.
394+
The CLA bot then checks if the primary email has signed the CLA.
395+
396+
4. The solution is to click the :guilabel:`CLA not signed -- click to sign`
397+
button in the backport PR.
398+
399+
.. tip:: Run ``git config user.email`` to see your Git client config,
400+
and append ``.patch`` to a PR URL to see the emails used for its commits:
401+
402+
* https://github.com/python/cpython/pull/1
403+
* https://github.com/python/cpython/pull/1.patch
404+
371405

372406
Submitting
373407
==========
@@ -547,7 +581,7 @@ affects other PRs.
547581

548582
If you still don't see where the failure originates from, check for
549583
a "This branch is out-of-date with the base branch" sign next to the
550-
list of executed checks. Clicking "Update branch" next to this message
584+
list of executed checks. Clicking :guilabel:`Update branch` next to this message
551585
will merge in the latest changes from the base branch into the PR.
552586

553587
If this still doesn't help with the failure on the PR, you can try

0 commit comments

Comments
 (0)