Merge branch 'main' into experimental

Author: leofang

cuda_python/docs/README.md

@@ -6,5 +6,18 @@
 
 Alternatively, we can build all the docs at once by running [`./build_all_docs.sh`](./build_all_docs.sh).
 
+When building the docs, some (but not all) of the urls can be rendered/examined locally by setting the environment
+variable `CUDA_PYTHON_DOMAIN` as follows:
+```shell
+CUDA_PYTHON_DOMAIN="http://localhost:1234/" ./build_all_docs.sh
+python -m http.server -d build/html 1234
+```
+If the docs are built on a remote machine, you can set up the ssh tunnel in a separate terminal session
+via
+```shell
+ssh -L 1234:localhost:1234 username@hostname
+```
+Then browse the built docs by visiting `http://localhost:1234/` on a local machine.
+
 To publish the docs with the built version, it is important to note that the html files of older versions
 should be kept intact, in order for the version selection (through `versions.json`) to work.

cuda_python/docs/build_all_docs.sh

@@ -13,7 +13,7 @@ pushd .
 cd ../../cuda_bindings/docs
 rm -rf build
 ./build_docs.sh
-cp -r build/html/* "$(dirs +1)"/$CUDA_BINDINGS_PATH
+cp -r build/html/* "$(dirs -l +1)"/$CUDA_BINDINGS_PATH
 popd
 
 # build cuda-core docs
@@ -23,5 +23,5 @@ pushd .
 cd ../../cuda_core/docs
 rm -rf build
 ./build_docs.sh
-cp -r build/html/* "$(dirs +1)"/$CUDA_CORE_PATH
+cp -r build/html/* "$(dirs -l +1)"/$CUDA_CORE_PATH
 popd