add sphinx documentation build to CI

[wholmgren]

A handful of recent PRs have broken the documentation build. We should add the documentation build to the azure pipelines CI configuration and fail it if the documentation errors.

[Peque]

Maybe you want to have a look at Autobuild Documentation for Pull Requests, since you are already using Read the Docs and GitHub.

[wholmgren]

Nice, thanks. My reading is that it's currently only available for readthedocs itself. Hoping I'm wrong or that it becomes more widely available soon. I imagine they might be faced with a large increase in compute needs.

[Peque]

Yeah, it is in beta. You can currently email them to enable the feature. Just wanted to link it here in case you want to try it early or in case it comes out of beta before anybody fixes this issue.

They will probably be faced with a large increase in compute needs, yeah, but I hope they can compensate that with paying subscriptions, as this was a largely requested feature for private repositories as well. 😊

[wholmgren]

Thanks, I emailed them.

[wholmgren]

RTD added us the the beta program and I modified our RTD webhook to support PR doc builds. Docs for existing PRs will be built after a new commit is pushed. For example: https://external-builds.readthedocs.io/html/pvlib-python/773/index.html

Thanks again for pointing out this feature!