Restructure docs and add metadata documentation

* Mention all three roles: user, script developer, developer role.
* Rename files.
* Write documentation for nested metadata structure.
2 jobs for !168 with 188-document-nested-metadata-structure in 1 minute and 47 seconds
latest merge request