Fix documentation build

[pquentin]

It took me a lot of time to understand that even with our version pins we were using PyOpenSSL's latest intersphinx mapping, and that it was incorrect: pyca/pyopenssl#1046.

[codecov]

Codecov Report

Merging #363 (c32b35d) into master (d4126fd) will not change coverage.
The diff coverage is n/a.

@@            Coverage Diff            @@
##            master      #363   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           10        10           
  Lines         1169      1169           
  Branches        46        46           
=========================================
  Hits          1169      1169           

[njsmith]

Oh shoot, that's tricky.

I'm worried about hard-coding a specific version in conf.py... it will inevitably get stale if we don't have some mechanism for updating it.

I'm actually talking to @reaperhulk about the next pyopenssl release right now, for the DTLS stuff -- maybe we can just fix this upstream?

[sethmlarson]

LGTM (sorry didn't see this already had a review on it)

[njsmith]

This is fixed in pyopenssl main branch now, so I guess our options are:

• merge and then revert as soon as pyopenssl releases
• switch to linking to the latest docs instead of stable
• do nothing and wait for pyopenssl to release, at which point this will fix itself

Next pyopenssl release will be right after pyca/pyopenssl#1026 is merged, and I'm nagging them to review it now, so hopefully soon.

[pquentin]

I like doing nothing, so let's wait a bit more. 👍

Thanks for the help and detailed post about our options!