diff --git a/doc/source/conf.py b/doc/source/conf.py
index ab063401..2814781b 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -195,8 +195,6 @@ html_sidebars = {
html_theme = "sphinx_rtd_theme"
-html_static_path = ['.static']
-
html_theme_options = {
'collapse_navigation': False,
'display_version': False
diff --git a/doc/source/working_with_images/clone_partitions.rst b/doc/source/working_with_images/clone_partitions.rst
index 4c4c5a4f..8feeebb0 100644
--- a/doc/source/working_with_images/clone_partitions.rst
+++ b/doc/source/working_with_images/clone_partitions.rst
@@ -33,6 +33,11 @@ Let's take a look at the following example:
+
+ 2048
+ false
+
+ 100
With the above setup {kiwi} will create a disk image that
@@ -48,8 +53,8 @@ contains the following partition table:
5 1275904 1296383 10.0 MiB 8300 p.lxhomeclone1
6 1296384 1316863 10.0 MiB 8300 p.lxhomeclone2
7 1316864 1337343 10.0 MiB 8300 p.lxhome
- 8 1337344 3864575 1.2 GiB 8300 p.lxrootclone1
- 9 3864576 6287326 1.2 GiB 8300 p.lxroot
+ 8 1337344 3864575 2 GiB 8300 p.lxrootclone1
+ 9 3864576 6287326 2 GiB 8300 p.lxroot
When booting the system only the origin partitions `p.lxboot`, `p.lxroot`
and `p.lxhome` will be mounted and visible in e.g. :file:`/etc/fstab`,
@@ -67,6 +72,25 @@ can hold that many partitions).
There is a limit how many partitions a partition table can hold.
This also limits how many clones can be created.
+It's important when using the `root_clone` attribute to specify a size for
+the part of the system that represents the root partition. As of today {kiwi}
+does not automatically divide the root partition into two identical pieces.
+In order to create a clone of the partition a size specification is required.
+In the above example the size for root is provided via the `oem-systemsize`
+element. Using a root clone and fixed size values has the following consequences:
+
+1. The resize capability must be disabled. This is done via `oem-resize`
+ element. The reason is that only the last partition in the partition
+ table can be resized without destroying data. If there is a clone of
+ the root partition it should never be resized because then the two
+ partitions will be different in size and no longer clones of each other
+
+2. There can be unpartitioned space left. In the above example the overall
+ disk size is set to 100G. The sum of all partition sizes will be smaller
+ than this value and there is no resize available anymore. Depending
+ on the overall size setup for the disk this will leave unpartitioned
+ space free on the disk.
+
Use Case
--------