mesonbuild / meson-python

Meson PEP 517 Python build backend
https://mesonbuild.com/meson-python/
MIT License
118 stars 59 forks source link

Update documentation on readthedocs to redirect to GitHub Pages #564

Open dnicolodi opened 5 months ago

dnicolodi commented 5 months ago

I don't have permissions to change the URL to the Github Pages hosted documentation.

Also, how hard would it be to redirect from the Read The Docs URL to the Github Pages one? AFAIK, the documentation on Read The Docs is not being updated anymore and it may be confusing for the users.

rgommers commented 5 months ago

I don't have permissions to change the URL to the Github Pages hosted documentation.

I fixed the link, and upgraded your permissions so you should now have access. Also, can I add you on PyPI (and if so, to make sure: this is you right: https://pypi.org/user/dnn/)?

Also, how hard would it be to redirect from the Read The Docs URL to the Github Pages one? AFAIK, the documentation on Read The Docs is not being updated anymore and it may be confusing for the users.

Last time I looked at this it wasn't possible to add a straight redirect, but for numpy we replaced the docs with a manual notice that the docs had moved: https://numpy.readthedocs.io/en/latest/. We could do that?

dnicolodi commented 5 months ago

I fixed the link, and upgraded your permissions so you should now have access.

Thanks @rgommers for the trust.

Also, can I add you on PyPI (and if so, to make sure: this is you right: https://pypi.org/user/dnn/)?

Yes, that's me.

dnicolodi commented 5 months ago

Last time I looked at this it wasn't possible to add a straight redirect, but for numpy we replaced the docs with a manual notice that the docs had moved: https://numpy.readthedocs.io/en/latest/. We could do that?

I never used readthedocs, but isn't it possible to upload an html file with something like

<meta http-equiv="refresh" content="0; url='https://mesonbuild.com/meson-python/'" />

in it?

rgommers commented 5 months ago

PyPI invite sent. It may be possible to upload such a redirect - I'll have to play with that later, so I'll leave this issue open for now (will change title, since the original issue was resolved).

lazka commented 4 months ago

I did something similar for another project recently, this worked for me (:splat inserts the part matched by the wildcard):

image

dnicolodi commented 3 months ago

@rgommers Have you had a chance to look at the solution proposed by @lazka ?