* chore: add pre-issue requirements Based on #1285 * docs: add header about documentation Based on #1285
* use real markdown headers for section titles * add a newline after the initial comment for readability * make hint indications comments