@@ -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
372406Submitting
373407==========
@@ -547,7 +581,7 @@ affects other PRs.
547581
548582If you still don't see where the failure originates from, check for
549583a "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
551585will merge in the latest changes from the base branch into the PR.
552586
553587If this still doesn't help with the failure on the PR, you can try
0 commit comments