Change python docs to pydata theme (#1785)

This PR changes docs theme from sphinx_rtd_theme to use pydata-theme: https://pydata-sphinx-theme.readthedocs.io/en/latest/

Authors:
  - GALI PREM SAGAR (https://github.com/galipremsagar)
  - Brad Rees (https://github.com/BradReesWork)

Approvers:
  - Brad Rees (https://github.com/BradReesWork)
  - AJ Schmidt (https://github.com/ajschmidt8)

URL: #1785

Author: galipremsagar

.gitignore

@@ -81,3 +81,6 @@ python/_external_repositories/
 
 # created by Dask tests
 python/dask-worker-space
+
+# Sphinx docs & build artifacts
+docs/cugraph/source/api_docs/api/*

SOURCEBUILD.md

@@ -49,6 +49,10 @@ conda env create --name cugraph_dev --file conda/environments/cugraph_dev_cuda11
 # for CUDA 11.2
 conda env create --name cugraph_dev --file conda/environments/cugraph_dev_cuda11.2.yml
 
+# for CUDA 11.4
+conda env create --name cugraph_dev --file conda/environments/cugraph_dev_cuda11.4.yml
+
+
 # activate the environment
 conda activate cugraph_dev
 

conda/environments/cugraph_dev_cuda11.0.yml

@@ -31,7 +31,7 @@ dependencies:
 - faiss-proc=*=cuda
 - scikit-learn>=0.23.1
 - sphinx
-- sphinx_rtd_theme
+- pydata-sphinx-theme
 - sphinxcontrib-websupport
 - sphinx-markdown-tables
 - sphinx-copybutton

conda/environments/cugraph_dev_cuda11.2.yml

@@ -31,7 +31,7 @@ dependencies:
 - faiss-proc=*=cuda
 - scikit-learn>=0.23.1
 - sphinx
-- sphinx_rtd_theme
+- pydata-sphinx-theme
 - sphinxcontrib-websupport
 - sphinx-markdown-tables
 - sphinx-copybutton

docs/cugraph/Makefile

@@ -4,7 +4,7 @@
 # You can set these variables from the command line.
 SPHINXOPTS    =
 SPHINXBUILD   = sphinx-build
-SPHINXPROJ    = cuGraph
+SPHINXPROJ    = cugraph
 SOURCEDIR     = source
 BUILDDIR      = build
 IMGDIR        = images
@@ -18,5 +18,4 @@ help:
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
-	cp -r $(SOURCEDIR)/$(IMGDIR) $(BUILDDIR)/html
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/cugraph/README.md

@@ -1,25 +1,28 @@
 # Building Documentation
 
-A basic python environment with packages listed in `./requirement.txt` is
-enough to build the docs.  Doc generation does not get run by default
+All prerequisite for building docs are in the cugraph development conda environment.
+[See build instructions](../../SOURCEBUILD.md) on how to create the development conda environment
 
-## Get additional dependency
+## Steps to follow:
 
-```bash
-pip install -r requirement.txt
-```
+In order to build the docs, we need the conda dev environment from cugraph and we need to build cugraph from source.  
+
+1. Create a conda env and build cugraph from source. The dependencies to build rapids from source are installed in that conda environment, and then rapids is built and installed into the same environment.
+
+2. Once cugraph is built from source, navigate to `../docs/cugraph/`. If you have your documentation written and want to turn it into HTML, run makefile:
 
-## Run makefile:
 
 ```bash
+# most be in the /docs/cugraph directory
 make html
 ```
 
-Outputs to `build/html/index.html`
+This should run Sphinx in your shell, and outputs to `build/html/index.html`
+
 
 ## View docs web page by opening HTML in browser:
 
-First navigate to `/build/html/` folder, i.e., `cd build/html` and then run the following command:
+First navigate to `/build/html/` folder, and then run the following command:
 
 ```bash
 python -m http.server