updated the main page with demo server references and a few more fixes
objects overall description reviewed
several common updates for the API part