diff --git a/content/en/contribute/documentation.md b/content/en/contribute/documentation.md
index 55b9fa487..b1fed4cb2 100644
--- a/content/en/contribute/documentation.md
+++ b/content/en/contribute/documentation.md
@@ -55,6 +55,13 @@ Step 7
 
 ## Including sample code
 
+{{% note %}}
+Use this syntax to include shortcodes calls within your code samples:
+
+`{{</*/* foo */*/>}}`\
+`{{%/*/* foo */*/%}}`
+{{% /note %}}
+
 ### Fenced code blocks
 
 Include the language when using a fenced code block.