The links aren't useless, but it has come up multiple times where users are confused what their purpose is for. The best explanation we have for them is here[0].
[0] https://bugs.launchpad.net/keystone/+bug/1674676/comments/3 ** Changed in: keystone Status: New => Opinion -- You received this bug notification because you are a member of Yahoo! Engineering Team, which is subscribed to OpenStack Identity (keystone). https://bugs.launchpad.net/bugs/1738946 Title: so many Relationship links in api-ref documentation are userless Status in OpenStack Identity (keystone): Opinion Bug description: so many Relationship links in api-ref doc are userless. for example, in api-ref/v3/users.inc file, the Relationship link of list users is 'https://docs.openstack.org/api/openstack- identity/3/rel/users', however, when I type in my chrome browser, it links to 'https://docs.openstack.org/pike/api/'. the same issue happens in roles.inc、projects.inc etc. To manage notifications about this bug go to: https://bugs.launchpad.net/keystone/+bug/1738946/+subscriptions -- Mailing list: https://launchpad.net/~yahoo-eng-team Post to : yahoo-eng-team@lists.launchpad.net Unsubscribe : https://launchpad.net/~yahoo-eng-team More help : https://help.launchpad.net/ListHelp