Improve SSL Certificate Verification details

[bbodenmiller]

Based on details provided at #6720 (comment) by @chrahunt

• Clarify --cert help text that setting --cert overrides default CA bundle
• Add more details to SSL Certificate Verification section about how it works

Fix #6720

Please use squash merge option when merging.

[BrownTruck]

Hello!

I am an automated bot and I have noticed that this pull request is not currently able to be merged. If you are able to either merge the master branch into this pull request or rebase this pull request against master then it will be eligible for code review and hopefully merging!

[uranusjr]

This needs a news fragment.

[bbodenmiller]

Any pointers on why CI is failing?

[uranusjr]

I think you need to break the message into more lines, it's exceeding the length limit.

[bbodenmiller]

I made it as short as other help texts and still seems to be failing. 🤔

[uranusjr]

 cert = partial(
     PipOption,
-    '--cert',
-    dest='cert',
-    type='path',
-    metavar='path',
+    "--cert",
+    dest="cert",
+    type="path",
+    metavar="path",

Not sure why the linter suddenly starts to care about quotes in this function 🤔 But let’s include the suggestion anyway, since we indeed prefer double quotes.

[pradyunsg]

Not sure why the linter suddenly starts to care about quotes in this function 🤔

Because this subpackage is finally enforced in CI to follow black -- see #9635.

[bbodenmiller]

Pipeline fixed