diff --git a/doc/sphinx/Pacemaker_Explained/ap-samples.rst b/doc/sphinx/Pacemaker_Explained/ap-samples.rst
index cbebe404be..641affc96e 100644
--- a/doc/sphinx/Pacemaker_Explained/ap-samples.rst
+++ b/doc/sphinx/Pacemaker_Explained/ap-samples.rst
@@ -1,156 +1,148 @@
Sample Configurations
---------------------
-.. Convert_to_RST:
+Empty
+#####
- [appendix]
-
-
- === Empty ===
-
- .An Empty Configuration
- =======
- [source,XML]
- -------
-
-
-
-
-
-
-
-
-
- -------
- =======
+.. topic:: An Empty Configuration
+
+ .. code-block:: xml
+
+
+
+
+
+
+
+
+
+
- === Simple ===
+Simple
+######
- .A simple configuration with two nodes, some cluster options and a resource
- =======
- [source,XML]
- -------
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- -------
- =======
+.. topic:: A simple configuration with two nodes, some cluster options and a resource
+
+ .. code-block:: xml
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
- In the above example, we have one resource (an IP address) that we check
- every five minutes and will run on host +c001n01+ until either the
- resource fails 10 times or the host shuts down.
+In the above example, we have one resource (an IP address) that we check
+every five minutes and will run on host ``c001n01`` until either the
+resource fails 10 times or the host shuts down.
- === Advanced Configuration ===
+Advanced Configuration
+######################
- .An advanced configuration with groups, clones and STONITH
- =======
- [source,XML]
- -------
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- -------
- =======
+.. topic:: An advanced configuration with groups, clones and STONITH
+
+ .. code-block:: xml
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+