diff --git a/doc/source/contributor/process.rst b/doc/source/contributor/process.rst
index f42856619c..19e90a4221 100644
--- a/doc/source/contributor/process.rst
+++ b/doc/source/contributor/process.rst
@@ -39,9 +39,9 @@ Dates overview
 For Victoria, please see:
 https://wiki.openstack.org/wiki/Nova/Victoria_Release_Schedule
 
-.. note: Throughout this document any link which references the name of a
-         release cycle in the link can usually be changed to the name of the
-         current cycle to get up to date information.
+.. note:: Throughout this document any link which references the name of a
+          release cycle in the link can usually be changed to the name of the
+          current cycle to get up to date information.
 
 Feature Freeze
 ~~~~~~~~~~~~~~
diff --git a/doc/source/contributor/ptl-guide.rst b/doc/source/contributor/ptl-guide.rst
index f167230ce3..3e4b2ab18c 100644
--- a/doc/source/contributor/ptl-guide.rst
+++ b/doc/source/contributor/ptl-guide.rst
@@ -179,7 +179,9 @@ Week following milestone 3
 
   * https://docs.openstack.org/nova/latest/contributor/process.html#non-priority-feature-freeze
 
-  * Note: if there is only a short time between FF and RC1 (lately it’s been 2
+  .. note::
+
+    if there is only a short time between FF and RC1 (lately it’s been 2
     weeks), then the only likely candidates will be low-risk things that are
     almost done