Feel free to improve the documentation by creating a branch and/or Pull-Reqeust.
To render notices we've added a custom markdown tag, you can use it like so:
-> This is somehting you should know
It wil render:
<div class="notice">
<p>This is somehting you should know.</p>
</div>