We need to extend the xml interface and op-mode definitions to have a docs tag like:
<docs> <text> foo bar</text> <hint class="danger">if you do this you must know that....</hint> <hint class="info">foo bar</hint> <codeexample>set system ...</codeexample> </docs>