diff --git a/docs/asciidoc_dos_and_donts.adoc b/docs/asciidoc_dos_and_donts.adoc
new file mode 100644
index 0000000000..7d5be0e987
--- /dev/null
+++ b/docs/asciidoc_dos_and_donts.adoc
@@ -0,0 +1,20 @@
+= AsciiDoc Dos & Don'ts
+
+=== Include
+
+When using multiple `include` statements, make sure that there is at least an empty line between them.
+
+==== Write
+
+----
+include::how-to-fix-it/core.adoc[]
+
+include::how-to-fix-it/symfony.adoc[]
+----
+
+==== Avoid
+
+----
+include::how-to-fix-it/core.adoc[]
+include::how-to-fix-it/symfony.adoc[]
+----