diff --git a/doc/language-design.txt b/doc/language-design.txt
index b948e1f..bfd0cc0 100644
--- a/doc/language-design.txt
+++ b/doc/language-design.txt
@@ -1,8 +1,8 @@
 notes:          dorémi abc... as they appear in the note list
-variables:      $v8
+variables:      $v8         assign '8' to the variable named 'v'
                 $v1+2
                 $vv+1
-                $v-4.1      as soon as the variable mutation string stops being valid, usual sheet music parsing continues
+                $v-4.1      as soon as the variable mutation string stops being valid, usual sheet music parsing continues (https://en.wikipedia.org/wiki/Maximal_munch)
 loops:          (...)
                 (2...)      to loop 2 times
                 (n...)      to loop n times (taking the integer part with the floor function)