Doc on microversions lacks hint on creating folder in api-samples

[Christian Rohmann]

This bug tracker is for errors with the documentation, use the following as a template and remove or add fields as you see fit. Convert [ ] into [x] to check boxes:

- [ ] This doc is inaccurate in this way: ______
- [x] This is a doc addition request.
- [ ] I have a fix to the document that I can paste below including example: input and output.

The documentation on API Microversions (https://docs.openstack.org/nova/latest/contributor/microversions.html#other-necessary-changes) lacks a hint that the contributor must create the subfolder with the new microversion in doc/api-samples/*/$NEW_MICROVERSION in order for the samples to be rendered as JSON files by `tox -e api-samples`.

i.e when adding a new microversion `v2.91` for servers I would need to create `doc/api-samples/servers/v2.91?`.

Apart from this documentation hint one might argue that the tox env could check for this consistency and give the contributor a proper and helpful error.

-----------------------------------
Release: 24.1.0.dev28 on 2020-04-10 11:42:50
SHA: 0a8f3e954485d2a6d80b80da50745cb7b0dbd048
Source: https://opendev.org/openstack/nova/src/doc/source/contributor/microversions.rst
URL: https://docs.openstack.org/nova/latest/contributor/microversions.html

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.opendev.org/c/openstack/nova/+/813672

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.opendev.org/c/openstack/nova/+/813672
Committed: https://opendev.org/openstack/nova/commit/6c5636baab934c9c404810a6ba2e7aed35ad2657
Submitter: "Zuul (22348)"
Branch: master

commit 6c5636baab934c9c404810a6ba2e7aed35ad2657
Author: Jan Hartkopf <email address hidden>
Date: Tue Oct 19 18:44:16 2021 +0200

    ensure samples folder exists for microversion

    When adding a microversion, a new corresponding folder
    for auto-generated samples is required.
    However, the folder has to be created manually for the
    generation to succeed.

    With this change, it is ensured that the folder
    is present, removing manual interaction.

    Closes-Bug: #1946771
    Change-Id: I18f2e509f8c1ae3ad5866b568afc6e0c341e5c3e
    Signed-off-by: Jan Hartkopf <email address hidden>

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/nova 25.0.0.0rc1 release candidate.