Coding: Restructure text about Prettier
@@ -374,8 +374,9 @@ Most notably use:
- Please use [**title-case**](https://en.wiktionary.org/wiki/title_case) for headings in the general documentation.
- For [man pages](help/) please use **only capital letters for subheadings** and only **small letters for the main header**. We use this header style to match the look and feel of man pages for Unix tools such as `ls` or `mkdir`.
-Please use [`prettier`](https://prettier.io) to format documentation according to the guidelines given above. If you want, you can also
-format all Markdown files in the repository using the script [`reformat-markdown`](/scripts/reformat-markdown).
+#### Prettier
+
+We use [`prettier`](https://prettier.io) to format the documentation according to the guidelines given above.
Under certain **exceptional** circumstances you might want to prevent `prettier` from formatting certain parts of a Markdown file. To do
that you can
@@ -385,6 +386,10 @@ that you can
.
+##### Usage
+
+If you want, you can format all Markdown files in the repository using the script [`reformat-markdown`](../scripts/reformat-markdown).
+
### Doxygen Guidelines
`doxygen` is used to document the API and to build the html and pdf output.
