Restore original README.md files in docs directories as requested

Co-authored-by: leofang <[email protected]>

Author: Copilot

cuda_bindings/docs/README.md

@@ -0,0 +1,11 @@
+# Build the documentation
+
+1. Install the `cuda-bindings` package of the version that we need to document.
+2. Ensure the version is included in the [`versions.json`](./versions.json).
+3. Build the docs with `./build_docs.sh`.
+4. The html artifacts should be available under both `./build/html/latest` and `./build/html/<version>`.
+
+Alternatively, we can build all the docs at once by running [`cuda_python/docs/build_all_docs.sh`](../../cuda_python/docs/build_all_docs.sh).
+
+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_bindings/docs/README.rst

@@ -0,0 +1,11 @@
+# Build the documentation
+
+1. Install the `cuda-core` package of the version that we need to document.
+2. Ensure the version is included in the [`versions.json`](./versions.json).
+3. Build the docs with `./build_docs.sh`.
+4. The html artifacts should be available under both `./build/html/latest` and `./build/html/<version>`.
+
+Alternatively, we can build all the docs at once by running [`cuda_python/docs/build_all_docs.sh`](../../cuda_python/docs/build_all_docs.sh).
+
+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_core/docs/README.md

@@ -0,0 +1,23 @@
+# Build the documentation
+
+1. Ensure the version is included in the [`versions.json`](./versions.json).
+2. Build the docs with `./build_docs.sh`.
+3. The html artifacts should be available under both `./build/html/latest` and `./build/html/<version>`.
+
+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.