v1 Image Service APIs in Image Service API Reference

[Sam Betts]

The v1.X image service APIs were removed in the Rocky release, this included the API reference docs. The API-ref docs don't provide stable versions like the main docs do e.g. docs.openstack.org/newton/glance which means there is no longer a published version of the v1 API reference even though Rocky is not yet released. This is very frustrating when trying to support older versions or even for reference back when trying to resolve the v1 deprecation.

[Brian Rosmaita (brian-rosmaita)]

Sam, that's a good point. I'll put it on the agenda for this week's Glance meeting.

[Brian Rosmaita (brian-rosmaita)]

We discussed this at the Glance meeting today:
http://eavesdrop.openstack.org/meetings/glance/2018/glance.2018-04-12-14.00.log.html#l-205

In short, we won't restore the v1 api-ref to the published docs, but we will put up a note explaining how you can recreate the api-ref for yourself. I'll keep this bug open and use it to track the "fix".

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/561063

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/561063
Committed: https://git.openstack.org/cgit/openstack/glance/commit/?id=012cce529f9201124ca864a9bca205df4db7296f
Submitter: Zuul
Branch: master

commit 012cce529f9201124ca864a9bca205df4db7296f
Author: Brian Rosmaita <email address hidden>
Date: Thu Apr 12 18:08:08 2018 -0400

    Add info about building the v1 api-ref

    Because the Image API is removed in Rocky, its API Reference has
    been deleted. Add information about why it's gone and how to build
    it to the current API Reference.

    Closes-bug: #1762387

    Change-Id: Ic215e7367b49df1ac837a4a1fa56effa7d9f7a61

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/glance 17.0.0.0b1 development milestone.