When writing the docs with Sphinx/MyST/Sphinx-Design there are cases where myst_substitutions
don’t work at all, it seems in directives for example. This makes it hard to create buttons that automatically point to the latest release binaries.
A feature that GitHub actually provides that I often see used by projects is a URL for the latest release:
https://github.com/OpenChemistry/avogadrolibs/releases/latest
and it is also possible to link to specific assets in this way using e.g.
https://github.com/OpenChemistry/avogadrolibs/releases/latest/download/Avogadro2-x86_64.AppImage.
Using this feature would mean that a dynamic URL wouldn’t even be necessary as the GitHub redirection would handle everything – but for the fact that the Mac and Windows binaries include the version number in their file names, which still needs to be updated on every release e.g. it’s
https://github.com/OpenChemistry/avogadrolibs/releases/latest/download/Avogadro2-1.99.0-Darwin.dmg
and not
https://github.com/OpenChemistry/avogadrolibs/releases/latest/download/Avogadro2-Darwin.dmg
Would you please consider enabling this by changing the GitHub Actions so that the version number is not included in the filenames? It’s already not the case for the Linux AppImage.
Ideally we’d also change the filenames in the 1.99.0 release too to allow the changes in the docs to be implemented already (which is very straightforward to do manually if you have the editing rights for the repo).