specifications update

[franck]

Hi

The specifications for the API description have been updated. We're near a 1.0 version, this should be the last important modification:

* format is now formats (since it's a list of possible format, the plural form feets better)

* author is renamed to authority

* remove the api_* prefix at top level

* add 'description' at top level

* in methods declaration, removed 'params', moved required and params at the same level in methods declaration, and renamed to required_params, optional_params

I won't add "authentication_type" because there is too many types of authentication that we won't be able to set.

For the implementation specification, we will add a 'spore.redirect' boolean, that will be used to inform the client if the request should follow redirection if needed.

Waiting for your comments :)

[franck]

I forgot: you can find the current specification at github http://github.com/SPORE/specifications