docs: add documentation about the structure/architecture of the code

docs: add documentation about the structure/architecture of the code #743