[DOC]: Instructions for hosting docs locally don't work

[ahendriksen]

Is this a duplicate?

• I confirmed there appear to be no duplicate issues for this bug and that I agree to the Code of Conduct

Is this for new documentation, or an update to existing docs?

New

Describe the incorrect/future/missing documentation

The following instructions from cccl/libcudacxx/docs/readme.md don't work flawlessly:

To build and serve the documentation as a website to http://localhost:4000 just execute the following from libcudacxx root directory:

./docs/serve

It seems that the currently configured base_url (link) does not work when hosting locally with a port.

The following change solves the problem locally, but not sure if that affects the hosted docs:

baseurl: "/cccl/libcudacxx"

If this is a correction, please provide a link to the incorrect documentation. If this is a new documentation request, please link to where you have looked.

https://github.com/NVIDIA/cccl/tree/main/libcudacxx/docs

[wmaxey]

Perhaps a solution is to supply the baseurl during our build of libcudacxx docs rather than build them assuming they are under CCCL.

Thanks for the heads up. I'll consider this when I begin touching the docs again unless someone beats me to it.