[iks-community] Some guidelines to document API of RESTful services

[Olivier Grisel]

I agree we need automated integration tests for the implementations
(run by a hudson server for instance), but they are not really
necessarily part of the documentation.

However it's a good practice to write the test scenarii as
specification before, or while developing the service, and not after
the development to help focus the API design on the consumer point of
view and not the implementers point of view (Test Driven Development).

-- 
Olivier