Software Engineering Guide has broken Reference

[Joel Sherrill]

Section 3, RTEMS Stakeholders, has a single paragraph which renders like this in the html at ​https://docs.rtems.org/branches/master/eng/stakeholders.html:

Please have a look at the Support and Contributing chapter of the ERROR: :r:url:`user`.

A bit of investigation shows that it is trying to link to ​https://docs.rtems.org/branches/master/user/support/index.html. That section appears to be there correctly.

Looking for documentation for the ":r:url:" syntax, I could not find any on the net. I see 48 uses of ":r:". I suspect but did not check that they all might be broken. What is ":r:" and what makes it work?

[Chris Johns]

You cannot have links like this to rolling released versions of the documentation in the documentation and it needs to be removed.

[Sebastian Huber]

This :r: stuff is implemented in common/rtemsdomain.py. It seems to be a Sphinx customization. It used to work at some point in time.

[Chris Johns]

The domains could have been broken by me when I updated that code to handle the version number change.

I will take a look. My comment about URL links is related to references between different documents only. References in a document is supported.

Sorry for the confusion.