diff --git a/documentation/using-coreos.rst b/documentation/using-coreos.rst
index e262a7f..c7582d1 100644
--- a/documentation/using-coreos.rst
+++ b/documentation/using-coreos.rst
@@ -199,6 +199,22 @@ Create the file `product/layers/meta-product/classes/product_metadata_scm.bbclas
 and copy the content of the coreos_metadata_scm.bbclass file. Replacing all
 reference to COREOS by PRODUCT should works.
 
+... start fast and easy development
+***********************************
+
+By adding `debug-tweaks` to `EXTRA_IMAGE_FEATURES` the image is made suitable
+for development. This allows for example root login with no password.
+For a complete list of the functionality that is added or removed by using
+`debug-tweaks` have a look at the official documentation.
+
+Following CoreOS specific functionality was added to `debug-tweaks`:
+
+* disables the read-only filesystem.
+
+.. warning::
+
+    This is for development only and must not be used for production images.
+
 ... set a root password
 ***********************