docs: improve initial documentation

[evegufy]

Description

improve initial documentation
findings from: #3

Pre-review checks

Please ensure to do as many of the following checks as possible, before asking for committer review:

• DEPENDENCIES are up-to-date. Dash license tool. Committers can open IP issues for restricted libs.
• Copyright and license header are present on all affected files

[matbmoser]

I needed to add some fix to the headers on the templates