There is a TODO in discoverability.rst under Guidance that states: "Add sections that describe a best practice for API discoverability, 15 possibly using JSON-Home, JSONSchema documents, and JSON-HAL." [1]
[1] https://github.com/openstack/api-wg/blame/384803a489af7ccdab59a2b52f6fa2c3e5db76c2/guidelines/discoverability.rst#L14
There is a TODO in discoverability.rst under Guidance that states: "Add sections that describe a best practice for API discoverability, 15 possibly using JSON-Home, JSONSchema documents, and JSON-HAL." [1]
[1] https:/ /github. com/openstack/ api-wg/ blame/384803a48 9af7ccdab59a2b5 2f6fa2c3e5db76c 2/guidelines/ discoverability .rst#L14