Prepare for 1.0.0 - update documentation

[AndreFavotto]

Update docs for 1.0.0 release

• Update docstrings;
• Check API endpoint descriptions (check via Swagger UI docs);
• Update README instructions and images;