@@ -362,6 +362,40 @@ Here are the steps needed in order to sign the CLA:
362362.. _contributor form : https://www.python.org/psf/contrib/contrib-form/
363363.. _Python Software Foundation : https://www.python.org/psf-landing/
364364
365+ Why do I need to sign the CLA again?
366+ ------------------------------------
367+
368+ Sometimes the CLA bot asks you to sign the CLA for a backport PR,
369+ when you've already signed it for the original PR.
370+ This is because you need to sign the CLA for all the email addresses you commit
371+ with.
372+
373+ This can happen when you've `configured your Git client
374+ <https://docs.github.com/en/account-and-profile/how-tos/email-preferences/setting-your-commit-email-address> `__
375+ with one email address, and signed the CLA with this, but have
376+ `configured your GitHub account <https://github.com/settings/emails >`__
377+ with another primary email
378+ (often this is the private ``id+username@users.noreply.github.com `` address).
379+
380+ 1. In the original PR, the CLA bot verifies all the emails in the commits have
381+ signed the CLA.
382+
383+ 2. We then squash merge the PR, which creates a single new commit using the
384+ author's primary email. This can be different from the one you originally
385+ committed with.
386+
387+ 3. Backports often only have this new single commit.
388+ The CLA bot then checks if the primary email has signed the CLA.
389+
390+ 4. The solution is to click the :guilabel: `CLA not signed -- click to sign `
391+ button in the backport PR.
392+
393+ .. tip :: Run ``git config user.email`` to see your Git client config,
394+ and append ``.patch `` to a PR URL to see the emails used for its commits:
395+
396+ * https://github.com/python/cpython/pull/1
397+ * https://github.com/python/cpython/pull/1.patch
398+
365399
366400Submitting
367401==========
@@ -541,7 +575,7 @@ affects other PRs.
541575
542576If you still don't see where the failure originates from, check for
543577a "This branch is out-of-date with the base branch" sign next to the
544- list of executed checks. Clicking " Update branch" next to this message
578+ list of executed checks. Clicking :guilabel: ` Update branch ` next to this message
545579will merge in the latest changes from the base branch into the PR.
546580
547581If this still doesn't help with the failure on the PR, you can try
0 commit comments