Differences

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

--- contributing [2025/02/10 12:53] – created karelkubicek
+++ contributing [2026/08/21 14:50] (current) – Boxes: <wrap> renders a span, use uppercase <WRAP>; one box per list, not per bullet karel.kubicek.claude
@@ Line 1: / Line 1: @@
 ====== Contributing ======
-Hello again and thanks for being interested in contributing to MeasureTheWeb! This page outlines some contributing concepts, such as the navigation structure of the wiki, how to use scientific citations, DokiWiki syntax, .
+Hello again and thanks for being interested in contributing to MeasureTheWeb! This page outlines some contributing concepts, both technical (page creation, syntax) and organizational (reviews, how to deal with subjective statements, and the code of conduct). Please read the page before contributing, thank you!
 You have to be registered to be able to edit and create content. You can create an account [[https://measuretheweb.org/contributing?do=register|here]].
@@ 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 ===