diff --git a/packages/mermaid/src/docs/syntax/userJourney.md b/packages/mermaid/src/docs/syntax/userJourney.md
index 3476088ab..0515ae814 100644
--- a/packages/mermaid/src/docs/syntax/userJourney.md
+++ b/packages/mermaid/src/docs/syntax/userJourney.md
@@ -20,3 +20,5 @@ Each user journey is split into sections, these describe the part of the task
 the user is trying to complete.
 
 Tasks syntax is `Task name: <score>: <comma separated list of actors>`
+
+Score is a number between 1 and 5, inclusive.