diff --git a/doc/openstack-ops/preface_ops.xml b/doc/openstack-ops/preface_ops.xml
index 3672c6d0..c653302b 100644
--- a/doc/openstack-ops/preface_ops.xml
+++ b/doc/openstack-ops/preface_ops.xml
@@ -458,4 +458,5 @@
             if you know how to fix it. Also, a member of the OpenStack
             doc-core team can triage the doc bug.</para>
     </section>
+    <xi:include href="section_conventions.xml"/>
 </preface>
diff --git a/doc/openstack-ops/section_conventions.xml b/doc/openstack-ops/section_conventions.xml
new file mode 100644
index 00000000..01ecb240
--- /dev/null
+++ b/doc/openstack-ops/section_conventions.xml
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<section xmlns="http://docbook.org/ns/docbook"
+    xmlns:xi="http://www.w3.org/2001/XInclude"
+    xmlns:xlink="http://www.w3.org/1999/xlink"
+    version="5.0"
+    xml:id="section_conventions">
+    <!-- This file is copied from
+         openstack-manuals/doc/common/section_conventions.xml.
+         Do not edit this file, edit the openstack-manuals one and copy it
+         here.-->
+    <?dbhtml stop-chunking?>
+    <title>Conventions</title>
+    <para>
+      The OpenStack documentation uses several typesetting conventions:
+    </para>
+
+    <simplesect xml:id="conventions-admonitions">
+    <title>Admonitions</title>
+      <para>
+        Admonitions take three forms:
+      </para>
+      <note>
+        <para>
+          This is a note. The information in a note is usually in the form
+          of a handy tip or reminder.
+        </para>
+      </note>
+      <important>
+        <para>
+          This is important. The information in an important admonition is
+          something you must be aware of before moving on.
+        </para>
+      </important>
+      <warning>
+        <para>
+          This is a warning. The information in warnings is critical.
+          Warnings provide additional information about risk of data loss or
+          security issues.
+        </para>
+      </warning>
+    </simplesect>
+
+    <simplesect xml:id="conventions-prompts">
+    <title>Command prompts</title>
+      <para>
+        Commands prefixed with the <literal>#</literal> prompt are to be
+        executed by the <literal>root</literal> user. These examples can
+        also be executed using the <command>sudo</command> command, if
+        available.
+      </para>
+      <para>
+        Commands prefixed with the <literal>$</literal> prompt can be
+        executed by any user, including <literal>root</literal>.
+      </para>
+    </simplesect>
+
+</section>