No anchors: Because swagger-ui is js-generated, we don't get anchors out of the box. We'd need a javascript wizard to send a patch on that. Do we know one?
Grouping: We may be able to add better grouping using a swagger-ui plugin. This video shows how on a slightly different context. Something to think for the future.
This adds rest-api generation to the docs.
api.json
from one of the two urls (whichever is available):https://docs.pulpproject.org/{repo_name}/api.json
https://docs.pulpproject.org/{repo_name}/_static/api.json
api.json
as we currently do (which is a fact I was missing).Observations (about rest api gen):
Preview
closes: #40