openstack team mailing list archive
-
openstack team
-
Mailing list archive
-
Message #13202
Re: Swift API Documentation Reviews
On Tue, Jun 12, 2012 at 9:16 AM, <Adrian_F_Smith@xxxxxxxx> wrote:
> 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/)
Nice, thanks you, I have done some review. How does it work for docs
does it need to have two core doing a +2 or one is enough?
> 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?
I'd say the two running in parallel.
> There are a few other gaps in the API docs but I wanted to get clarification before proceeding.
Thanks,
Chmouel.
Follow ups
References