openstack team mailing list archive

[<Adrian_F_Smith@xxxxxxxx>]

Hi,

For anyone interested in documentation I've posted two changes in relation to the Swift API docs,

Describe the end_marker parameter (https://review.openstack.org/#/c/8375/)
Added section on metadata at account level (https://review.openstack.org/#/c/8374/)

end_marker has been a feature since Nov-2010.
Account metadata has been a feature since Aug-2010.

Since the API documents are versioned (currently 1.0) is it right to retrospectively update them now? Is the documentation a spec and Swift an implementation of that spec or are the two running in parallel?

There are a few other gaps in the API docs but I wanted to get clarification before proceeding.

Adrian