Add nx-cugraph Docs Pages

[nv-rliu]

Closes https://github.com/rapidsai/graph_dl/issues/606 and [another issue]

Proposed Changes

In preparation for GA release, this PR adds a landing page for nx-cugraph in the cugraph API documentation site. The new pages can be viewed by clicking nx-cugraph in the navigation bar at the top of the page.

New pages

nx-cugraph
└─ How it works
└─ Supported Algorithms
└─ Getting Started
└─ Benchmarks
└─ FAQ

Notes for Reviewers

• In order to build and test these docs, I modified the build.sh file to use sphinx-autobuild.

122
123     cd ${REPODIR}/docs/cugraph-docs
124     #make html
125     sphinx-autobuild source build/html
126 fi
127

• For now, I believe the best way to view these changes is to clone the PR branch, then run build.sh in order to host the webserver locally..

[acostadon]

Found some small things but looks good. Still reviewing.

[acostadon]

Looks good

[rlratzel]

Thanks, Ralph. This is a great start. I have a few requests below.

[eriknw]

This is a huge improvement, thank you!

I left a few questions and suggestions, and I have a few questions below.

Should we update the "url" in the get_info function? This controls the link to nx-cugraph from the NetworkX docs

cugraph/python/nx-cugraph/_nx_cugraph/__init__.py

Line 39 in 9b107b9

"url": f"https://github.com/rapidsai/cugraph/tree/branch-{_version_major:0>2}.{_version_minor:0>2}/python/nx-cugraph",

Is the algorithm list in supported-algorithms.rst automated? Is it complete? Should we (eventually) try to automate it in a similar way that we update the README using scripts/update_readme.py? Or, can we add a test to ensure it's complete?

Can we link to the official NetworkX docs for backends again in how-it-works.md? I know we already link to NetworkX in index.rst.

[rlratzel]

Should we update the "url" in the get_info function? This controls the link to nx-cugraph from the NetworkX docs

cugraph/python/nx-cugraph/_nx_cugraph/__init__.py

Line 39 in 9b107b9

"url": f"https://github.com/rapidsai/cugraph/tree/branch-{_version_major:0>2}.{_version_minor:0>2}/python/nx-cugraph",

Yes, I was just going to open a PR to update that. We'll have our proper landing in place by next week and (I think) a temporary redirect in place even sooner, so lets update it to: https://rapids.ai/nx-cugraph (this is the nx-cugraph equivalent of the cudf-pandas landing page)

[eriknw]

How is nxcg-execution-diagram.jpg created? Is it from code, and, if so, is this code available somewhere?

[nv-rliu]

How is nxcg-execution-diagram.jpg created? Is it from code, and, if so, is this code available somewhere?

@eriknw it is not code. It was created by Rick for the SciPy talk and it was borrowed from the presentation.

[BradReesWork]

/merge