* restructured the documentation
* add details from specs
* add tables and Mermaid diagrams whenever possible