Update REST API doc

All examples/codes of the REST API doc should use `curl` instead of java/js clients etc. 
curl XXXX if  exemple executable sur un nuxeo stock
ou
POST|GET http://

------ 

• Homepage
  • overview
• Authentication — (quid de auth oauth2?) Proxy Oauth, portal SSO
• Special HTTP Headers
• Entity types
  • format de reponse de l'api rest + présentation en cas d’erreur
  • les entities peuvent etre enrichies via content enrichers / fetch properties - exemples avant/apres etc
    > Document
    Présenter l’entity type Document puis les Fetch properties et les content enrichers associés
    > Documents
    ...
    >DirectoryEntry
    …
    >DirectoryEntries
    …
    >Group
    >User
    >Acl
    >Workflow
    >Task
    //////
• Endpoints
  • Overview, où ils sont, URLs etc.
    > document
    > users
    > groups
    > search
    > upload blob (HOWTO: Upload a File in Nuxeo Using REST API)
    > …
    //////
• Web Adapters
  • Overview
    > document
    > groups
    > users
    //////
• CORS
  //////
• API playground
  //////
• Advanced/Developper/Go further
  > JSON Marshalling
  > Extend the REST API
  > dev angular2
  > dev react redux