update documentation

add new features:

• set up Swagger based documentation for web API

(list not exaustive at the moment)