Currently the docs sub-project directly includes the source files from the parent project which causes tight coupling of the docs build process to the parent project.
For example switching to the faster build of docusaurus does not work out-of-the-box because of this.