The reason we have a separate website and docs is that the docs are specific to a version (e.g. pandas 1.5.3), while the website is global to all versions and updated in real time.
For historic reasons, we have several things that are not version specific in the docs, which IMHO doesn't add any value and brings confusion and extra work backporting and keeping things sync. To be specific, what's in the docs that is not version dependent is:
The change is not trivial for two reasons:
For the development documentation I think the second point is not a big problem, but for the release notes we do use references to the API a lot. Not sure if it's worth the migration, but creating an issue anyway for visibility of the problem, and in case anyone has comments.