Instance reservation documentation is outdated

[Pierre Riteau]

https://docs.openstack.org/blazar/latest/user/architecture.html#virtual-instance-reservation contains outdated information: it hasn't been updated since the new implementation has been released.

[Radosław Piliszek (yoctozepto)]

This is most misleading. I am happy to collaborate on this issue.

[Radosław Piliszek (yoctozepto)]

priteau has confirmed on IRC that we only have specs and code as references.

Code, being the obvious source of truth, could obviously lack insight which is present in the specs. There are 3 relevant specs in total that affect the inner- and outerworkings of instance reservation (in order):

https://specs.openstack.org/openstack/blazar-specs/specs/pike/new-instance-reservation.html
https://specs.openstack.org/openstack/blazar-specs/specs/queens/flavors-extra-specs.html
https://specs.openstack.org/openstack/blazar-specs/specs/rocky/placement-api.html

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.opendev.org/c/openstack/blazar/+/852301
Committed: https://opendev.org/openstack/blazar/commit/e93abfe5369fcdcde470f68266b8d73b175f73b1
Submitter: "Zuul (22348)"
Branch: master

commit e93abfe5369fcdcde470f68266b8d73b175f73b1
Author: Radosław Piliszek <email address hidden>
Date: Sat Aug 6 18:53:06 2022 +0200

    [docs] Rewrite the architecture description

    To match the reality.

    Closes-Bug: #1801794
    Change-Id: I5f2044da0efcbe3e091d25f97d69fec877858d7e

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/blazar 11.0.0.0rc1 release candidate.