[BD-21] Fix API docs generation and update swagger.yml

[regisb]

API docs generation was being blocked by missing values in the doc
settings. We wanted to update the swagger.yml to get the toggle state
("/toggles/v0/state/") endpoint in the docs.

cc @nedbat and @robrap.

[openedx-webhooks]

Thanks for the pull request, @regisb! I've created BLENDED-649 to keep track of it in Jira. More details are on the BD-21 project page.

When this pull request is ready, tag your edX technical lead.

[regisb]

I doubt the broken test is related to the changes from this PR. This is ready for review.

[robrap]

jenkins run py38 python

[edx-status-bot]

Your PR has finished running tests. There were no failures.

[robrap]

@regisb: Is this PR the minimum required to fix? If not, could we have a PR for that and separate out any additions/improvements?
@nedbat: Could you or someone from @edx/teaching-and-learning review this?

[regisb]

Is this PR the minimum required to fix?

@robrap Pretty much, yes. The only additional thing I did was to actually run make api-docs, which made sense in this context (IMHO).

[robrap]

@regisb: Oh. I have no idea how the swagger docs work. So, all the changes in docs/swagger.yaml are generated. I didn't understand that. Seems like we should have a job to keep these docs up to date, but that is beyond this PR.

[edx-pipeline-bot]

EdX Release Notice: This PR has been deployed to the staging environment in preparation for a release to production.

[edx-pipeline-bot]

EdX Release Notice: This PR has been deployed to the production environment.