SONATA-124 - Updating doc

* Proofreading documentation
* Updating doc formatting
* Updating the index