diff --git a/doc/source/examples.rst b/doc/source/examples.rst
new file mode 100644
index 0000000..3d92fb0
--- /dev/null
+++ b/doc/source/examples.rst
@@ -0,0 +1,94 @@
+
+===================
+Allocation Examples
+===================
+
+    
+
+ceph_ds_multiple_disk
+-----------------
+
+Hardware information
+~~~~~~~~~~~~~~~~~~~~
+
+.. literalinclude:: schemas/multiple_disk.yaml
+    :language: yaml
+
+Dynamic schema
+~~~~~~~~~~~~~~
+.. literalinclude:: schemas/ceph_ds.yaml
+    :language: yaml
+
+Allocation result
+~~~~~~~~~~~~~~~~~
+
+.. image:: schemas/ceph_ds_multiple_disk.svg
+        :width: 100%
+
+        
+
+ceph_ds_single_disk
+-----------------
+
+Hardware information
+~~~~~~~~~~~~~~~~~~~~
+
+.. literalinclude:: schemas/single_disk.yaml
+    :language: yaml
+
+Dynamic schema
+~~~~~~~~~~~~~~
+.. literalinclude:: schemas/ceph_ds.yaml
+    :language: yaml
+
+Allocation result
+~~~~~~~~~~~~~~~~~
+
+.. image:: schemas/ceph_ds_single_disk.svg
+        :width: 100%
+
+        
+
+simple_os_ds_multiple_disk
+-----------------
+
+Hardware information
+~~~~~~~~~~~~~~~~~~~~
+
+.. literalinclude:: schemas/multiple_disk.yaml
+    :language: yaml
+
+Dynamic schema
+~~~~~~~~~~~~~~
+.. literalinclude:: schemas/simple_os_ds.yaml
+    :language: yaml
+
+Allocation result
+~~~~~~~~~~~~~~~~~
+
+.. image:: schemas/simple_os_ds_multiple_disk.svg
+        :width: 100%
+
+        
+
+simple_os_ds_single_disk
+-----------------
+
+Hardware information
+~~~~~~~~~~~~~~~~~~~~
+
+.. literalinclude:: schemas/single_disk.yaml
+    :language: yaml
+
+Dynamic schema
+~~~~~~~~~~~~~~
+.. literalinclude:: schemas/simple_os_ds.yaml
+    :language: yaml
+
+Allocation result
+~~~~~~~~~~~~~~~~~
+
+.. image:: schemas/simple_os_ds_single_disk.svg
+        :width: 100%
+
+        
\ No newline at end of file
diff --git a/doc/source/schemas/ceph_ds_multiple_disk.svg b/doc/source/schemas/ceph_ds_multiple_disk.svg
new file mode 100644
index 0000000..25d3a2d
--- /dev/null
+++ b/doc/source/schemas/ceph_ds_multiple_disk.svg
@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<svg baseProfile="full" height="100%" preserveAspectRatio="none" version="1.1" viewBox="0 0 650.0 480" width="100%" xmlns="http://www.w3.org/2000/svg" xmlns:ev="http://www.w3.org/2001/xml-events" xmlns:xlink="http://www.w3.org/1999/xlink"><defs /><g id="disks-group" transform="translate(30, 30)"><g id="sda" transform="translate(0, 0)"><text fill="black">sda size=10000</text><g id="in-sda" transform="translate(0, 10)"><rect height="2cm" rx="5" ry="5" style="fill:#f5f5f5;stroke:black;stroke-width:5;" width="450.0" x="0" y="0" /><rect height="2cm" id="root" rx="5" ry="5" style="fill:#666547;stroke:black;stroke-width:5;" width="225.0" x="0" y="0" /><rect height="2cm" id="swap" rx="5" ry="5" style="fill:#fb2e01;stroke:black;stroke-width:5;" width="92.16" x="225.0" y="0" /><rect height="2cm" id="ceph" rx="5" ry="5" style="fill:#6fcb9f;stroke:black;stroke-width:5;" width="0.0" x="317.16" y="0" /><rect height="2cm" id="ceph-journal" rx="5" ry="5" style="fill:#ffe28a;stroke:black;stroke-width:5;" width="0.0" x="317.16" y="0" /><rect height="2cm" id="unallocated" rx="5" ry="5" style="fill:#b9feb3;stroke:black;stroke-width:5;" width="132.84" x="317.16" y="0" /><text fill="#666547" x="460.0" y="20">root size=5000</text><text fill="#fb2e01" x="460.0" y="40">swap size=2048</text><text fill="#6fcb9f" x="460.0" y="60">ceph size=0</text><text fill="#ffe28a" x="460.0" y="80">ceph-journal size=0</text><text fill="#b9feb3" x="460.0" y="100">unallocated size=2952</text></g></g><g id="sdb" transform="translate(0, 110)"><text fill="black">sdb size=10000</text><g id="in-sdb" transform="translate(0, 10)"><rect height="2cm" rx="5" ry="5" style="fill:#f5f5f5;stroke:black;stroke-width:5;" width="450.0" x="0" y="0" /><rect height="2cm" id="root" rx="5" ry="5" style="fill:#666547;stroke:black;stroke-width:5;" width="0.0" x="0" y="0" /><rect height="2cm" id="swap" rx="5" ry="5" style="fill:#fb2e01;stroke:black;stroke-width:5;" width="0.0" x="0.0" y="0" /><rect height="2cm" id="ceph" rx="5" ry="5" style="fill:#6fcb9f;stroke:black;stroke-width:5;" width="450.0" x="0.0" y="0" /><rect height="2cm" id="ceph-journal" rx="5" ry="5" style="fill:#ffe28a;stroke:black;stroke-width:5;" width="0.0" x="450.0" y="0" /><rect height="2cm" id="unallocated" rx="5" ry="5" style="fill:#b9feb3;stroke:black;stroke-width:5;" width="0.0" x="450.0" y="0" /><text fill="#666547" x="460.0" y="20">root size=0</text><text fill="#fb2e01" x="460.0" y="40">swap size=0</text><text fill="#6fcb9f" x="460.0" y="60">ceph size=10000</text><text fill="#ffe28a" x="460.0" y="80">ceph-journal size=0</text><text fill="#b9feb3" x="460.0" y="100">unallocated size=0</text></g></g><g id="sdc" transform="translate(0, 220)"><text fill="black">sdc size=10000</text><g id="in-sdc" transform="translate(0, 10)"><rect height="2cm" rx="5" ry="5" style="fill:#f5f5f5;stroke:black;stroke-width:5;" width="450.0" x="0" y="0" /><rect height="2cm" id="root" rx="5" ry="5" style="fill:#666547;stroke:black;stroke-width:5;" width="0.0" x="0" y="0" /><rect height="2cm" id="swap" rx="5" ry="5" style="fill:#fb2e01;stroke:black;stroke-width:5;" width="0.0" x="0.0" y="0" /><rect height="2cm" id="ceph" rx="5" ry="5" style="fill:#6fcb9f;stroke:black;stroke-width:5;" width="450.0" x="0.0" y="0" /><rect height="2cm" id="ceph-journal" rx="5" ry="5" style="fill:#ffe28a;stroke:black;stroke-width:5;" width="0.0" x="450.0" y="0" /><rect height="2cm" id="unallocated" rx="5" ry="5" style="fill:#b9feb3;stroke:black;stroke-width:5;" width="0.0" x="450.0" y="0" /><text fill="#666547" x="460.0" y="20">root size=0</text><text fill="#fb2e01" x="460.0" y="40">swap size=0</text><text fill="#6fcb9f" x="460.0" y="60">ceph size=10000</text><text fill="#ffe28a" x="460.0" y="80">ceph-journal size=0</text><text fill="#b9feb3" x="460.0" y="100">unallocated size=0</text></g></g><g id="sde" transform="translate(0, 330)"><text fill="black">sde size=2048</text><g id="in-sde" transform="translate(0, 10)"><rect height="2cm" rx="5" ry="5" style="fill:#f5f5f5;stroke:black;stroke-width:5;" width="92.16" x="0" y="0" /><rect height="2cm" id="root" rx="5" ry="5" style="fill:#666547;stroke:black;stroke-width:5;" width="0.0" x="0" y="0" /><rect height="2cm" id="swap" rx="5" ry="5" style="fill:#fb2e01;stroke:black;stroke-width:5;" width="0.0" x="0.0" y="0" /><rect height="2cm" id="ceph" rx="5" ry="5" style="fill:#6fcb9f;stroke:black;stroke-width:5;" width="0.0" x="0.0" y="0" /><rect height="2cm" id="ceph-journal" rx="5" ry="5" style="fill:#ffe28a;stroke:black;stroke-width:5;" width="92.16" x="0.0" y="0" /><rect height="2cm" id="unallocated" rx="5" ry="5" style="fill:#b9feb3;stroke:black;stroke-width:5;" width="0.0" x="92.16" y="0" /><text fill="#666547" x="102.16" y="20">root size=0</text><text fill="#fb2e01" x="102.16" y="40">swap size=0</text><text fill="#6fcb9f" x="102.16" y="60">ceph size=0</text><text fill="#ffe28a" x="102.16" y="80">ceph-journal size=2048</text><text fill="#b9feb3" x="102.16" y="100">unallocated size=0</text></g></g></g></svg>
\ No newline at end of file
diff --git a/doc/source/schemas/ceph_ds_single_disk.svg b/doc/source/schemas/ceph_ds_single_disk.svg
new file mode 100644
index 0000000..8020d82
--- /dev/null
+++ b/doc/source/schemas/ceph_ds_single_disk.svg
@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<svg baseProfile="full" height="100%" preserveAspectRatio="none" version="1.1" viewBox="0 0 650.0 120" width="100%" xmlns="http://www.w3.org/2000/svg" xmlns:ev="http://www.w3.org/2001/xml-events" xmlns:xlink="http://www.w3.org/1999/xlink"><defs /><g id="disks-group" transform="translate(30, 30)"><g id="sda" transform="translate(0, 0)"><text fill="black">sda size=10000</text><g id="in-sda" transform="translate(0, 10)"><rect height="2cm" rx="5" ry="5" style="fill:#f5f5f5;stroke:black;stroke-width:5;" width="450.0" x="0" y="0" /><rect height="2cm" id="root" rx="5" ry="5" style="fill:#666547;stroke:black;stroke-width:5;" width="225.0" x="0" y="0" /><rect height="2cm" id="swap" rx="5" ry="5" style="fill:#fb2e01;stroke:black;stroke-width:5;" width="92.16" x="225.0" y="0" /><rect height="2cm" id="ceph" rx="5" ry="5" style="fill:#6fcb9f;stroke:black;stroke-width:5;" width="132.84" x="317.16" y="0" /><rect height="2cm" id="ceph-journal" rx="5" ry="5" style="fill:#ffe28a;stroke:black;stroke-width:5;" width="0.0" x="450.0" y="0" /><rect height="2cm" id="unallocated" rx="5" ry="5" style="fill:#b9feb3;stroke:black;stroke-width:5;" width="0.0" x="450.0" y="0" /><text fill="#666547" x="460.0" y="20">root size=5000</text><text fill="#fb2e01" x="460.0" y="40">swap size=2048</text><text fill="#6fcb9f" x="460.0" y="60">ceph size=2952</text><text fill="#ffe28a" x="460.0" y="80">ceph-journal size=0</text><text fill="#b9feb3" x="460.0" y="100">unallocated size=0</text></g></g></g></svg>
\ No newline at end of file
diff --git a/doc/source/schemas/simple_os_ds_multiple_disk.svg b/doc/source/schemas/simple_os_ds_multiple_disk.svg
new file mode 100644
index 0000000..1fac65e
--- /dev/null
+++ b/doc/source/schemas/simple_os_ds_multiple_disk.svg
@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<svg baseProfile="full" height="100%" preserveAspectRatio="none" version="1.1" viewBox="0 0 650.0 480" width="100%" xmlns="http://www.w3.org/2000/svg" xmlns:ev="http://www.w3.org/2001/xml-events" xmlns:xlink="http://www.w3.org/1999/xlink"><defs /><g id="disks-group" transform="translate(30, 30)"><g id="sda" transform="translate(0, 0)"><text fill="black">sda size=10000</text><g id="in-sda" transform="translate(0, 10)"><rect height="2cm" rx="5" ry="5" style="fill:#f5f5f5;stroke:black;stroke-width:5;" width="450.0" x="0" y="0" /><rect height="2cm" id="root" rx="5" ry="5" style="fill:#666547;stroke:black;stroke-width:5;" width="225.0" x="0" y="0" /><rect height="2cm" id="swap" rx="5" ry="5" style="fill:#fb2e01;stroke:black;stroke-width:5;" width="0.0" x="225.0" y="0" /><rect height="2cm" id="log" rx="5" ry="5" style="fill:#6fcb9f;stroke:black;stroke-width:5;" width="45.0" x="225.0" y="0" /><rect height="2cm" id="data_var_lib" rx="5" ry="5" style="fill:#ffe28a;stroke:black;stroke-width:5;" width="180.0" x="270.0" y="0" /><rect height="2cm" id="unallocated" rx="5" ry="5" style="fill:#b9feb3;stroke:black;stroke-width:5;" width="0.0" x="450.0" y="0" /><text fill="#666547" x="460.0" y="20">root size=5000</text><text fill="#fb2e01" x="460.0" y="40">swap size=0</text><text fill="#6fcb9f" x="460.0" y="60">log size=1000</text><text fill="#ffe28a" x="460.0" y="80">data_var_lib size=4000</text><text fill="#b9feb3" x="460.0" y="100">unallocated size=0</text></g></g><g id="sdb" transform="translate(0, 110)"><text fill="black">sdb size=10000</text><g id="in-sdb" transform="translate(0, 10)"><rect height="2cm" rx="5" ry="5" style="fill:#f5f5f5;stroke:black;stroke-width:5;" width="450.0" x="0" y="0" /><rect height="2cm" id="root" rx="5" ry="5" style="fill:#666547;stroke:black;stroke-width:5;" width="0.0" x="0" y="0" /><rect height="2cm" id="swap" rx="5" ry="5" style="fill:#fb2e01;stroke:black;stroke-width:5;" width="0.0" x="0.0" y="0" /><rect height="2cm" id="log" rx="5" ry="5" style="fill:#6fcb9f;stroke:black;stroke-width:5;" width="0.0" x="0.0" y="0" /><rect height="2cm" id="data_var_lib" rx="5" ry="5" style="fill:#ffe28a;stroke:black;stroke-width:5;" width="450.0" x="0.0" y="0" /><rect height="2cm" id="unallocated" rx="5" ry="5" style="fill:#b9feb3;stroke:black;stroke-width:5;" width="0.0" x="450.0" y="0" /><text fill="#666547" x="460.0" y="20">root size=0</text><text fill="#fb2e01" x="460.0" y="40">swap size=0</text><text fill="#6fcb9f" x="460.0" y="60">log size=0</text><text fill="#ffe28a" x="460.0" y="80">data_var_lib size=10000</text><text fill="#b9feb3" x="460.0" y="100">unallocated size=0</text></g></g><g id="sdc" transform="translate(0, 220)"><text fill="black">sdc size=10000</text><g id="in-sdc" transform="translate(0, 10)"><rect height="2cm" rx="5" ry="5" style="fill:#f5f5f5;stroke:black;stroke-width:5;" width="450.0" x="0" y="0" /><rect height="2cm" id="root" rx="5" ry="5" style="fill:#666547;stroke:black;stroke-width:5;" width="0.0" x="0" y="0" /><rect height="2cm" id="swap" rx="5" ry="5" style="fill:#fb2e01;stroke:black;stroke-width:5;" width="0.0" x="0.0" y="0" /><rect height="2cm" id="log" rx="5" ry="5" style="fill:#6fcb9f;stroke:black;stroke-width:5;" width="0.0" x="0.0" y="0" /><rect height="2cm" id="data_var_lib" rx="5" ry="5" style="fill:#ffe28a;stroke:black;stroke-width:5;" width="450.0" x="0.0" y="0" /><rect height="2cm" id="unallocated" rx="5" ry="5" style="fill:#b9feb3;stroke:black;stroke-width:5;" width="0.0" x="450.0" y="0" /><text fill="#666547" x="460.0" y="20">root size=0</text><text fill="#fb2e01" x="460.0" y="40">swap size=0</text><text fill="#6fcb9f" x="460.0" y="60">log size=0</text><text fill="#ffe28a" x="460.0" y="80">data_var_lib size=10000</text><text fill="#b9feb3" x="460.0" y="100">unallocated size=0</text></g></g><g id="sde" transform="translate(0, 330)"><text fill="black">sde size=2048</text><g id="in-sde" transform="translate(0, 10)"><rect height="2cm" rx="5" ry="5" style="fill:#f5f5f5;stroke:black;stroke-width:5;" width="92.16" x="0" y="0" /><rect height="2cm" id="root" rx="5" ry="5" style="fill:#666547;stroke:black;stroke-width:5;" width="0.0" x="0" y="0" /><rect height="2cm" id="swap" rx="5" ry="5" style="fill:#fb2e01;stroke:black;stroke-width:5;" width="92.16" x="0.0" y="0" /><rect height="2cm" id="log" rx="5" ry="5" style="fill:#6fcb9f;stroke:black;stroke-width:5;" width="0.0" x="92.16" y="0" /><rect height="2cm" id="data_var_lib" rx="5" ry="5" style="fill:#ffe28a;stroke:black;stroke-width:5;" width="0.0" x="92.16" y="0" /><rect height="2cm" id="unallocated" rx="5" ry="5" style="fill:#b9feb3;stroke:black;stroke-width:5;" width="0.0" x="92.16" y="0" /><text fill="#666547" x="102.16" y="20">root size=0</text><text fill="#fb2e01" x="102.16" y="40">swap size=2048</text><text fill="#6fcb9f" x="102.16" y="60">log size=0</text><text fill="#ffe28a" x="102.16" y="80">data_var_lib size=0</text><text fill="#b9feb3" x="102.16" y="100">unallocated size=0</text></g></g></g></svg>
\ No newline at end of file
diff --git a/doc/source/schemas/simple_os_ds_single_disk.svg b/doc/source/schemas/simple_os_ds_single_disk.svg
new file mode 100644
index 0000000..36cee9d
--- /dev/null
+++ b/doc/source/schemas/simple_os_ds_single_disk.svg
@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<svg baseProfile="full" height="100%" preserveAspectRatio="none" version="1.1" viewBox="0 0 650.0 120" width="100%" xmlns="http://www.w3.org/2000/svg" xmlns:ev="http://www.w3.org/2001/xml-events" xmlns:xlink="http://www.w3.org/1999/xlink"><defs /><g id="disks-group" transform="translate(30, 30)"><g id="sda" transform="translate(0, 0)"><text fill="black">sda size=10000</text><g id="in-sda" transform="translate(0, 10)"><rect height="2cm" rx="5" ry="5" style="fill:#f5f5f5;stroke:black;stroke-width:5;" width="450.0" x="0" y="0" /><rect height="2cm" id="root" rx="5" ry="5" style="fill:#666547;stroke:black;stroke-width:5;" width="225.0" x="0" y="0" /><rect height="2cm" id="swap" rx="5" ry="5" style="fill:#fb2e01;stroke:black;stroke-width:5;" width="92.16" x="225.0" y="0" /><rect height="2cm" id="log" rx="5" ry="5" style="fill:#6fcb9f;stroke:black;stroke-width:5;" width="45.0" x="317.16" y="0" /><rect height="2cm" id="data_var_lib" rx="5" ry="5" style="fill:#ffe28a;stroke:black;stroke-width:5;" width="87.84" x="362.16" y="0" /><rect height="2cm" id="unallocated" rx="5" ry="5" style="fill:#b9feb3;stroke:black;stroke-width:5;" width="0.0" x="450.0" y="0" /><text fill="#666547" x="460.0" y="20">root size=5000</text><text fill="#fb2e01" x="460.0" y="40">swap size=2048</text><text fill="#6fcb9f" x="460.0" y="60">log size=1000</text><text fill="#ffe28a" x="460.0" y="80">data_var_lib size=1952</text><text fill="#b9feb3" x="460.0" y="100">unallocated size=0</text></g></g></g></svg>
\ No newline at end of file