Build docs on CI

[jakirkham]

We recently started adding docs to ucx-py. ( #273 ) Would be good to test that they build as part of CI. One option would be to do this as part of gpuCI. Not sure how this is handled. Another would be to enable the beta ReadTheDocs feature for building PRs. We could also do both.

[pentschev]

@jakirkham could you confirm if this is still relevant? I'm not sure what's the current status.

[jakirkham]

It's not done currently. Would be nice to do.

[quasiben]

So folks are aware of what we are doing now:

1. RTD does not have libnuma installed on build machines and UCX throw an error on import if it does not exist. To over come this issue I build and uploaded a UCX conda package without numa

2. RTD is currently pointed at my branch of ucx-py which points to the nonuma conda package: https://github.com/quasiben/ucx-py/blob/56482570fe37d99c2df73ba2e8c478c047052e74/conda/environments/builddocs_py37.yml#L19

3. when we merge doc edits I merge my branch with latest edits and manually trigger a build

This system is not great...

[jakirkham]

FWIW RTD is working on adding apt-get support ( readthedocs/readthedocs.org#8065 ). So that might be another way to address installing libnuma

[jakirkham]

OPS recently enabled PR builds for RTD, which addresses the original issue.

On the libnuma point, have a rough PR ( #734 ) to use the new RTD apt support, which they are deploying next Tuesday afternoon. So that should address this secondary issue.

Given this will go ahead and close this out as the original issue was already addressed and the 2nd point soon will be