diff --git a/examples/documentation/oxdoc_tutorial/js/example.js b/examples/documentation/oxdoc_tutorial/js/example.js
index 3369028b..f0164e7e 100644
--- a/examples/documentation/oxdoc_tutorial/js/example.js
+++ b/examples/documentation/oxdoc_tutorial/js/example.js
@@ -1,3 +1,8 @@
+/*
+
+**OxDoc Tutorial**
+*/
+
/*
An `OxDoc` comment is an inline or multi-line comment that starts with `@`:
```
@@ -13,12 +18,18 @@ it doesn't, its meaning depends on its context.
this.My = {};
+/*
+**Sections**
+*/
/*
If the first line of the comment doesn't match `name summary`, it is a
section definition. Here, it marks a section named 'Primitives'.
*/
//@ Primitives
+/*
+**Name, Type, Summary**
+*/
/*
This inline comment documents an item by providing its name, type and one-line
summary.
@@ -26,6 +37,9 @@ summary.
//@ My.REQUEST_TIMEOUT Request timeout, in milliseconds
My.REQUEST_TIMEOUT = 60000;
+/*
+**Descriptions**
+*/
/*
In a multiline comment, lines that follow the inital definition are indented, as
they refer to the item defined in the line above. Lines that don't match `name
@@ -45,15 +59,22 @@ This defines a new section named 'Objects'.
//@ Objects
/*
-A line that starts with `#` is an inline comment that will be ignored by the
-parser.
+**Comments, Properties, Events, Tests**
+*/
+/*
+A line that starts with `#` is a comment, and will be ignored by the parser.
The following lines document properties of the `My.favorites` object. This
example shows all possible values for `type`. These values can be shortened —
it's sufficient to specify their first character.
+If an object fires events, they can be documented as well.
+
A line that starts with `>` is an inline test statement, followed by the
-expected result. (Yes, it's that simple!)
+expected result. (Yes, it's that simple!) A benefit of inline tests is the fact
+that they're not just machine-, but also human-readable. As an illustration of a
+function's behavior, they are often more compact and comprehensible than a long
+description.
*/
/*@
My.favorite