New vs Old Documentation URLs


#1

The portal.hdgroup.org URLs have a nice feature in that they encode the name of the function n the URL:
https://portal.hdfgroup.org/display/HDF5/H5D_CLOSE

The new docs.hdfgroup.org URLs use numbered “title” anchors.
https://docs.hdfgroup.org/hdf5/develop/group___h5_d.html#title7

I would be nice if the new docs had predictable anchors for the function names. For example, it would great if the following worked.
https://docs.hdfgroup.org/hdf5/develop/group___h5_d.html#H5D_CLOSE

In the Julia language package HDF5.jl, we generate our documentation with links to the online HDF5 documentation because of the predictability of the URLs. It would be sad to lose this if the old documentation were to go away.
https://juliaio.github.io/HDF5.jl/stable/api_bindings/#HDF5.API.h5d_close


#2

I’m not sure how much control we have over the URL fragment generation. I think Doxygen guarantees they are stable for a given function prototype, but not much else. I need to dig a little deeper into the Doxygen documentation. I think there was an option to export some kind of a sitemap…

G.