Location of new Doxygen documentation, etc.
I'm very surprised, I must confess, to read that the new Doxygen documentation is being put under URLs such as https://lhcb-doxygen.web.cern.ch/lhcb-doxygen/stacks/RTA/2023.07.04/index.html, see the comment !166 (comment 6930645) in MR !166 (merged). I don't think this is viable at all. Let me make several comments and questions, cc @clemenci, @rmatev, @cmarinbe, @decianm, @nskidmor, @pkoppenb:
-
How can analysts and colleagues in general find out such magic URLs, especially that even the "root URL" https://lhcb-doxygen.web.cern.ch/lhcb-doxygen/ returns a 403 - Forbidden hence nothing that hints at how to get a list of available sets of docs.
-
Speaking of the list, where is the list being produced for all new stacks so that people can find what they need? In the old times you would go, say, to https://lhcbdoc.web.cern.ch/lhcbdoc/rec/releases. This is being updated but not https://lhcbdoc.web.cern.ch/lhcbdoc/moore/releases/, for example, see my next point. In any case, the links under https://lhcb-doxygen.web.cern.ch/lhcb-doxygen/stacks/RTA/2023.07.04/index.html do not tell you or point you to the relevant tag under https://lhcbdoc.web.cern.ch/lhcbdoc/rec/releases and others.
-
I checked for the sake of argument the Moore link and https://lhcb-doxygen.web.cern.ch/lhcb-doxygen/stacks/RTA/2023.07.04/index.html and am taken to https://gitlab.cern.ch/lhcb/Moore/-/tree/v54r12?ref_type=tags, which gives the repository at the branch corresponding to the tag rather than the expected documentation for the tag.
-
If the CalVer tags + project label (2023.07.04 and RTA in this instance, respectively) now get explicit in the URLs, how will people be able to know what to look for? We have for example RTA and DPA stack releases, sometimes DaVinci being part of an RTA stack, sometimes not, etc. This is going to get messy and cryptic IMO.
I know it was a lot of work to get Doxygen up and running again, and we should be really grateful - I certainly am. I just want to point out that there are some rough edges, either known or not quite appreciated.