diff --git a/doc/operating-kolla.rst b/doc/operating-kolla.rst
index f8285682d5..1bdaa88971 100644
--- a/doc/operating-kolla.rst
+++ b/doc/operating-kolla.rst
@@ -100,5 +100,5 @@ node to get the admin openrc file.
 ``kolla-ansible -i INVENTORY check`` is used to do post-deployment smoke
 tests.
 
-.. note:: In order to do smoke tests, requires
-``kolla_enable_sanity_checks=yes``.
+.. note::
+  In order to do smoke tests, requires ``kolla_enable_sanity_checks=yes``.
diff --git a/doc/zun-guide.rst b/doc/zun-guide.rst
index 7eb067e04e..a0b2653597 100644
--- a/doc/zun-guide.rst
+++ b/doc/zun-guide.rst
@@ -9,7 +9,7 @@ Preparation and Deployment
 --------------------------
 
 To allow Zun Compute connect to the Docker Daemon, add the following in the
-``docker.service` file on each zun-compute node.
+``docker.service`` file on each zun-compute node.
 
 ::