diff --git a/doc/Pacemaker_Explained/en-US/images/Policy-Engine-big.dot b/doc/Pacemaker_Explained/en-US/images/Policy-Engine-big.dot
new file mode 100644
index 0000000000..40ced22ccc
--- /dev/null
+++ b/doc/Pacemaker_Explained/en-US/images/Policy-Engine-big.dot
@@ -0,0 +1,83 @@
+digraph "g" {
+"Cancel drbd0:0_monitor_10000 frigg" -> "drbd0:0_demote_0 frigg" [ style = bold]
+"Cancel drbd0:0_monitor_10000 frigg" [ style=bold color="green" fontcolor="black" ]
+"Cancel drbd0:1_monitor_12000 odin" -> "drbd0:1_promote_0 odin" [ style = bold]
+"Cancel drbd0:1_monitor_12000 odin" [ style=bold color="green" fontcolor="black" ]
+"IPaddr0_monitor_5000 odin" [ style=bold color="green" fontcolor="black" ]
+"IPaddr0_start_0 odin" -> "IPaddr0_monitor_5000 odin" [ style = bold]
+"IPaddr0_start_0 odin" -> "MailTo_start_0 odin" [ style = bold]
+"IPaddr0_start_0 odin" -> "group_running_0" [ style = bold]
+"IPaddr0_start_0 odin" [ style=bold color="green" fontcolor="black" ]
+"MailTo_start_0 odin" -> "group_running_0" [ style = bold]
+"MailTo_start_0 odin" [ style=bold color="green" fontcolor="black" ]
+"drbd0:0_demote_0 frigg" -> "drbd0:0_monitor_12000 frigg" [ style = bold]
+"drbd0:0_demote_0 frigg" -> "ms_drbd_demoted_0" [ style = bold]
+"drbd0:0_demote_0 frigg" [ style=bold color="green" fontcolor="black" ]
+"drbd0:0_monitor_12000 frigg" [ style=bold color="green" fontcolor="black" ]
+"drbd0:0_post_notify_demote_0 frigg" -> "ms_drbd_confirmed-post_notify_demoted_0" [ style = bold]
+"drbd0:0_post_notify_demote_0 frigg" [ style=bold color="green" fontcolor="black" ]
+"drbd0:0_post_notify_promote_0 frigg" -> "ms_drbd_confirmed-post_notify_promoted_0" [ style = bold]
+"drbd0:0_post_notify_promote_0 frigg" [ style=bold color="green" fontcolor="black" ]
+"drbd0:0_pre_notify_demote_0 frigg" -> "ms_drbd_confirmed-pre_notify_demote_0" [ style = bold]
+"drbd0:0_pre_notify_demote_0 frigg" [ style=bold color="green" fontcolor="black" ]
+"drbd0:0_pre_notify_promote_0 frigg" -> "ms_drbd_confirmed-pre_notify_promote_0" [ style = bold]
+"drbd0:0_pre_notify_promote_0 frigg" [ style=bold color="green" fontcolor="black" ]
+"drbd0:1_monitor_10000 odin" [ style=bold color="green" fontcolor="black" ]
+"drbd0:1_post_notify_demote_0 odin" -> "ms_drbd_confirmed-post_notify_demoted_0" [ style = bold]
+"drbd0:1_post_notify_demote_0 odin" [ style=bold color="green" fontcolor="black" ]
+"drbd0:1_post_notify_promote_0 odin" -> "ms_drbd_confirmed-post_notify_promoted_0" [ style = bold]
+"drbd0:1_post_notify_promote_0 odin" [ style=bold color="green" fontcolor="black" ]
+"drbd0:1_pre_notify_demote_0 odin" -> "ms_drbd_confirmed-pre_notify_demote_0" [ style = bold]
+"drbd0:1_pre_notify_demote_0 odin" [ style=bold color="green" fontcolor="black" ]
+"drbd0:1_pre_notify_promote_0 odin" -> "ms_drbd_confirmed-pre_notify_promote_0" [ style = bold]
+"drbd0:1_pre_notify_promote_0 odin" [ style=bold color="green" fontcolor="black" ]
+"drbd0:1_promote_0 odin" -> "drbd0:1_monitor_10000 odin" [ style = bold]
+"drbd0:1_promote_0 odin" -> "ms_drbd_promoted_0" [ style = bold]
+"drbd0:1_promote_0 odin" [ style=bold color="green" fontcolor="black" ]
+"group_running_0" [ style=bold color="green" fontcolor="orange" ]
+"group_start_0" -> "IPaddr0_start_0 odin" [ style = bold]
+"group_start_0" -> "MailTo_start_0 odin" [ style = bold]
+"group_start_0" -> "group_running_0" [ style = bold]
+"group_start_0" [ style=bold color="green" fontcolor="orange" ]
+"ms_drbd_confirmed-post_notify_demoted_0" -> "drbd0:0_monitor_12000 frigg" [ style = bold]
+"ms_drbd_confirmed-post_notify_demoted_0" -> "drbd0:1_monitor_10000 odin" [ style = bold]
+"ms_drbd_confirmed-post_notify_demoted_0" -> "ms_drbd_pre_notify_promote_0" [ style = bold]
+"ms_drbd_confirmed-post_notify_demoted_0" [ style=bold color="green" fontcolor="orange" ]
+"ms_drbd_confirmed-post_notify_promoted_0" -> "drbd0:0_monitor_12000 frigg" [ style = bold]
+"ms_drbd_confirmed-post_notify_promoted_0" -> "drbd0:1_monitor_10000 odin" [ style = bold]
+"ms_drbd_confirmed-post_notify_promoted_0" -> "group_start_0" [ style = bold]
+"ms_drbd_confirmed-post_notify_promoted_0" [ style=bold color="green" fontcolor="orange" ]
+"ms_drbd_confirmed-pre_notify_demote_0" -> "ms_drbd_demote_0" [ style = bold]
+"ms_drbd_confirmed-pre_notify_demote_0" -> "ms_drbd_post_notify_demoted_0" [ style = bold]
+"ms_drbd_confirmed-pre_notify_demote_0" [ style=bold color="green" fontcolor="orange" ]
+"ms_drbd_confirmed-pre_notify_promote_0" -> "ms_drbd_post_notify_promoted_0" [ style = bold]
+"ms_drbd_confirmed-pre_notify_promote_0" -> "ms_drbd_promote_0" [ style = bold]
+"ms_drbd_confirmed-pre_notify_promote_0" [ style=bold color="green" fontcolor="orange" ]
+"ms_drbd_demote_0" -> "drbd0:0_demote_0 frigg" [ style = bold]
+"ms_drbd_demote_0" -> "ms_drbd_demoted_0" [ style = bold]
+"ms_drbd_demote_0" [ style=bold color="green" fontcolor="orange" ]
+"ms_drbd_demoted_0" -> "ms_drbd_post_notify_demoted_0" [ style = bold]
+"ms_drbd_demoted_0" -> "ms_drbd_promote_0" [ style = bold]
+"ms_drbd_demoted_0" [ style=bold color="green" fontcolor="orange" ]
+"ms_drbd_post_notify_demoted_0" -> "drbd0:0_post_notify_demote_0 frigg" [ style = bold]
+"ms_drbd_post_notify_demoted_0" -> "drbd0:1_post_notify_demote_0 odin" [ style = bold]
+"ms_drbd_post_notify_demoted_0" -> "ms_drbd_confirmed-post_notify_demoted_0" [ style = bold]
+"ms_drbd_post_notify_demoted_0" [ style=bold color="green" fontcolor="orange" ]
+"ms_drbd_post_notify_promoted_0" -> "drbd0:0_post_notify_promote_0 frigg" [ style = bold]
+"ms_drbd_post_notify_promoted_0" -> "drbd0:1_post_notify_promote_0 odin" [ style = bold]
+"ms_drbd_post_notify_promoted_0" -> "ms_drbd_confirmed-post_notify_promoted_0" [ style = bold]
+"ms_drbd_post_notify_promoted_0" [ style=bold color="green" fontcolor="orange" ]
+"ms_drbd_pre_notify_demote_0" -> "drbd0:0_pre_notify_demote_0 frigg" [ style = bold]
+"ms_drbd_pre_notify_demote_0" -> "drbd0:1_pre_notify_demote_0 odin" [ style = bold]
+"ms_drbd_pre_notify_demote_0" -> "ms_drbd_confirmed-pre_notify_demote_0" [ style = bold]
+"ms_drbd_pre_notify_demote_0" [ style=bold color="green" fontcolor="orange" ]
+"ms_drbd_pre_notify_promote_0" -> "drbd0:0_pre_notify_promote_0 frigg" [ style = bold]
+"ms_drbd_pre_notify_promote_0" -> "drbd0:1_pre_notify_promote_0 odin" [ style = bold]
+"ms_drbd_pre_notify_promote_0" -> "ms_drbd_confirmed-pre_notify_promote_0" [ style = bold]
+"ms_drbd_pre_notify_promote_0" [ style=bold color="green" fontcolor="orange" ]
+"ms_drbd_promote_0" -> "drbd0:1_promote_0 odin" [ style = bold]
+"ms_drbd_promote_0" [ style=bold color="green" fontcolor="orange" ]
+"ms_drbd_promoted_0" -> "group_start_0" [ style = bold]
+"ms_drbd_promoted_0" -> "ms_drbd_post_notify_promoted_0" [ style = bold]
+"ms_drbd_promoted_0" [ style=bold color="green" fontcolor="orange" ]
+}
diff --git a/doc/Pacemaker_Explained/en-US/images/Policy-Engine-big.svg b/doc/Pacemaker_Explained/en-US/images/Policy-Engine-big.svg
new file mode 100644
index 0000000000..7964fcfd30
--- /dev/null
+++ b/doc/Pacemaker_Explained/en-US/images/Policy-Engine-big.svg
@@ -0,0 +1,418 @@
+
+
+
+
+
diff --git a/doc/Pacemaker_Explained/en-US/images/Policy-Engine-small.dot b/doc/Pacemaker_Explained/en-US/images/Policy-Engine-small.dot
new file mode 100644
index 0000000000..3fef81e789
--- /dev/null
+++ b/doc/Pacemaker_Explained/en-US/images/Policy-Engine-small.dot
@@ -0,0 +1,31 @@
+ digraph "g" {
+"rsc1_monitor_0 pcmk-2" -> "probe_complete pcmk-2" [ style = bold]
+"rsc1_monitor_0 pcmk-2" [ style=bold color="green" fontcolor="black" ]
+"rsc1_stop_0 pcmk-1" [ style=dashed color="red" fontcolor="black" ]
+"rsc1_start_0 pcmk-2" [ style=dashed color="red" fontcolor="black" ]
+"rsc1_stop_0 pcmk-1" -> "rsc1_start_0 pcmk-2" [ style = dashed ]
+"rsc1_stop_0 pcmk-1" -> "all_stopped" [ style = dashed ]
+"probe_complete" -> "rsc1_start_0 pcmk-2" [ style = dashed ]
+
+"rsc2_monitor_0 pcmk-2" -> "probe_complete pcmk-2" [ style = bold]
+"rsc2_monitor_0 pcmk-2" [ style=bold color="green" fontcolor="black" ]
+"rsc2_stop_0 pcmk-1" [ style=dashed color="red" fontcolor="black" ]
+"rsc2_start_0 pcmk-2" [ style=dashed color="red" fontcolor="black" ]
+"rsc2_stop_0 pcmk-1" -> "rsc2_start_0 pcmk-2" [ style = dashed ]
+"rsc2_stop_0 pcmk-1" -> "all_stopped" [ style = dashed ]
+"probe_complete" -> "rsc2_start_0 pcmk-2" [ style = dashed ]
+
+"rsc3_monitor_0 pcmk-2" -> "probe_complete pcmk-2" [ style = bold]
+"rsc3_monitor_0 pcmk-2" [ style=bold color="green" fontcolor="black" ]
+"rsc3_stop_0 pcmk-1" [ style=dashed color="blue" fontcolor="orange" ]
+"rsc3_start_0 pcmk-2" [ style=dashed color="blue" fontcolor="black" ]
+"rsc3_stop_0 pcmk-1" -> "all_stopped" [ style = dashed ]
+"probe_complete" -> "rsc3_start_0 pcmk-2" [ style = dashed ]
+
+"probe_complete pcmk-2" -> "probe_complete" [ style = bold]
+"probe_complete pcmk-2" [ style=bold color="green" fontcolor="black" ]
+"probe_complete" [ style=bold color="green" fontcolor="orange" ]
+
+"all_stopped" [ style=dashed color="red" fontcolor="orange" ]
+
+}
diff --git a/doc/Pacemaker_Explained/en-US/images/Policy-Engine-small.svg b/doc/Pacemaker_Explained/en-US/images/Policy-Engine-small.svg
new file mode 100644
index 0000000000..a020d564f8
--- /dev/null
+++ b/doc/Pacemaker_Explained/en-US/images/Policy-Engine-small.svg
@@ -0,0 +1,133 @@
+
+
+
+
+