Problem description
Currently the documentation-files, e.g., API-design-guideline.md has some broken internal references (e.g., inside the table of content).
Also some other issues were found like:

• unformated tables
• too long sentences, which were hardly to read on the first try.
• missing articles
• some grammar issues