Add info for development, tests and production usage. List all known
issues about the API.

Signed-off-by: Renato Cordeiro Ferreira <renato.cferreira@hotmail.com>