Link checker CI: forbidden access

[andersy005]

link-checker CI has been complaining about broken external links from GitHub... the links do exist. it's just that for some reason GitHub servers appear to refuse granting access...

i don't know how to fix this :). if someone has a clue, please chime in.

[brian-rose]

Weird.

Should we consider disabling the link-checker until a fix is found?

[kmpaul]

I'm wondering if we can make link-checker optional, and not required.

[kmpaul]

Or do we just ignore it for now?

[kmpaul]

Turns out this issue comes up with any GitHub URL in a "blank" Sphinx document. I've created an issue on the Sphinx repo to document it:

sphinx-doc/sphinx#10343

[kmpaul]

Temporarily, would could ignore linkchecker on any docs.github.com links with the Sphinx option:

linkcheck_ignore = [r'https://docs.github.com']

but I don't like this option for very long!

[brian-rose]

I think this is the right approach. It's hard to make progress on everything else with all those nasty looking CI failures.

[kmpaul]

Ok. Then I'm going to push that change to @andersy005's #259 PR.

[kmpaul]

This is now fixed with the merge of #259. However, it is a hack, so I'm going to create a standing issue to remove the linkcheck_ignore Sphinx option when sphinx-doc/sphinx#10343 is resolved, if ever.