diff --git a/doc/source/admin/identity-caching-layer.rst b/doc/source/admin/identity-caching-layer.rst
index 36744f47e5..652b45a462 100644
--- a/doc/source/admin/identity-caching-layer.rst
+++ b/doc/source/admin/identity-caching-layer.rst
@@ -6,7 +6,7 @@ Caching layer
OpenStack Identity supports a caching layer that is above the configurable
subsystems (for example, token). This gives you the flexibility to setup
caching for all or some subsystems. OpenStack Identity uses the `oslo.cache
-`__ library which allows
+`__ library which allows
flexible cache back ends. The majority of the caching configuration options are
set in the ``[cache]`` section of the ``/etc/keystone/keystone.conf`` file. The
``enabled`` option of the ``[cache]`` section must be set to ``True`` in order
diff --git a/keystone/tests/unit/test_sql_upgrade.py b/keystone/tests/unit/test_sql_upgrade.py
index 0c757b6ec2..df1f0f0cfb 100644
--- a/keystone/tests/unit/test_sql_upgrade.py
+++ b/keystone/tests/unit/test_sql_upgrade.py
@@ -28,7 +28,7 @@ To run these tests against a live database:
tox -e py27 -- keystone.tests.unit.test_sql_upgrade
For further information, see `oslo.db documentation
-`_.
+`_.
WARNING::