diff --git a/content/en/docs/contribute/style/style-guide.md b/content/en/docs/contribute/style/style-guide.md
index 19a35679cb..cd228c0748 100644
--- a/content/en/docs/contribute/style/style-guide.md
+++ b/content/en/docs/contribute/style/style-guide.md
@@ -287,6 +287,16 @@ The output is:
 
 1. Bake for 20-25 minutes or until set.
 
+### Include Statements
+
+Shortcodes inside include statements will break the build. You must insert them in the parent document, before and after you call the include. For example:
+
+```
+{{</* note */>}}
+{{</* include "federation-current-state.md" */>}}
+{{</* /note */>}}
+```
+
 ## Content best practices
 
 This section contains suggested best practices for clear, concise, and consistent content.