fsfe
strange renaming of filenames
While preparing a package for Gentoo building of the docs failed we found a strange change of filenames. We fixed it with a dirty patch and everything builds again. https://github.com/gentoo/gentoo/pull/33895/files#diff-69830a6b290a88118491417c503dae61d52afec497d4e0eb3055b1c54d9209d6 Also I think the files should not change names.
I just had a look at this.
The reason the files README.md etc are copied to docs/ as part of the Sphinx compilation is because—if these files were symlinks instead—they would not be included in the sdist as such.
The reason they are relative links (../README.md) is because you're supposed to run make html inside of the docs/ directory.
The reason the files 'change names' is arbitrary. It affects the URL slug.
There is a way to make your patch unnecessary by making the paths relative to the value of __file__, which is an absolute path to docs/conf.py. PR welcome.
