extend the core documentation

[zoltuz]

• [] update your master branch
• [] Create a future branch from the master branch (git checkout -b docs_extension)
• [] add documentation stubs based on dictionary_builder
• [] open a PR with the changes

Thanks!