[REVIEW] Change docs theme to pydata-sphinx theme

[galipremsagar]

This PR:

• Switches the python docs theme to pydata-sphinx-theme to be uniform with rest of the rapids python docs.
• Fixes typos
• Fixes a number of formatting and alignment issues in docstrings.
• Discuss with cuml team on how(if any) and where things should be placed.

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[cjnolet]

I ran this locally and it really looks great to me overall. I like that the GitHub and RAPIDS twitter links are right on the top and I was having fun playing with the light/dark color modes. The code all appears to display nicely and the source links work.

The only thing I would change is to shorten the top-level section headings just a tad. Small things like removing "cuml" (since cuml is already displayed on the left and users already know the docs are for cuml) from section headings on the top could help make things easier to consume.

We can discuss that stuff further, though, and open follow-up PRs if we feel it should be changed.

[beckernick]

Do we need this file anymore? https://github.com/rapidsai/cuml/blob/branch-22.12/conda/environments/builddocs_py36.yml

[Can discuss in follow ups]

[galipremsagar]

Do we need this file anymore? https://github.com/rapidsai/cuml/blob/branch-22.12/conda/environments/builddocs_py36.yml

[Can discuss in follow ups]

Not at all, I've used [cuml_dev_cuda11.5.yml] to build and deploy the docs. Will remove it as part of this PR.

[galipremsagar]

I ran this locally and it really looks great to me overall. I like that the GitHub and RAPIDS twitter links are right on the top and I was having fun playing with the light/dark color modes. The code all appears to display nicely and the source links work.

The only thing I would change is to shorten the top-level section headings just a tad. Small things like removing "cuml" (since cuml is already displayed on the left and users already know the docs are for cuml) from section headings on the top could help make things easier to consume.

We discuss that stuff further, though, and open follow-up PRs if we feel it should be changed.

Yup, can shorten those. Will do it here.

[cjnolet]

@galipremsagar just holding this PR open while you make the changes so it doesn't accidentally get merged.

[galipremsagar]

@cjnolet @beckernick Addressed your reviews and this should be ready for another look. The top bar will now look much cleaner, let me know what you think.

[galipremsagar]

rerun tests

[cjnolet]

@gpucibot merge

[codecov-commenter]

Codecov Report

❗ No coverage uploaded for pull request base (branch-22.12@0f19b92). Click here to learn what that means.
Patch has no changes to coverable lines.

Additional details and impacted files

@@               Coverage Diff               @@
##             branch-22.12    #4985   +/-   ##
===============================================
  Coverage                ?   79.60%           
===============================================
  Files                   ?      184           
  Lines                   ?    11698           
  Branches                ?        0           
===============================================
  Hits                    ?     9312           
  Misses                  ?     2386           
  Partials                ?        0           

Flag	Coverage Δ
dask	45.93% <0.00%> (?)
non-dask	69.14% <0.00%> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report at Codecov.
📢 Do you have feedback about the report comment? Let us know in this issue.