Differences

This shows you the differences between two versions of the page.

--- contributing [2025/03/04 13:33] – [Contributing] finished sentence karelkubicek
+++ contributing [2026/09/17 07:22] (current) – Markup rendering sweep: wrap escapes, CLI flag typography, and heading quotes. Authored by Claude. karel.kubicek.claude
@@ Line 62: / Line 62: @@
 === Code ===
-For short inline monospace, use ''double quotes''. For proper code (in a separate paragraph), use ''<code LANG>'':
+For short inline monospace, use ''double quotes''. For proper code (in a separate paragraph), use ''%%<code LANG>%%'':
   <code python>
@@ Line 68: / Line 68: @@
   </code>
-For large code, use ''<file LANG filename>''; this will make the code downloadable. For instance:
+For large code, use ''%%<file LANG filename>%%''; this will make the code downloadable. For instance:
 <code>
@@ Line 81: / Line 81: @@
 print('Hello world!')
 </file>
+=== Boxes ===
+Notes, warnings and open-question boxes use the **uppercase** ''<nowiki><WRAP></nowiki>'' tag, which renders a ''<nowiki><div></nowiki>'':
+  <WRAP todo>
+  Paragraphs, lists and tables can all go inside a box like this.
+  </WRAP>
+The lowercase ''<nowiki><wrap></nowiki>'' renders a ''<nowiki><span></nowiki>'' instead. A span cannot contain block content, so a lowercase box holding more than a few words of running text is silently mangled — the page renders wrong without any error. **Always use uppercase.** If a box holds a bullet list, put the whole list inside one box rather than opening a box per bullet.
 === Figures ===