diff --git a/doc/design-2.0-commandline-parameters.rst b/doc/design-2.0-commandline-parameters.rst
index 7964d6f66300137acd5a5d3fa84cd5eeaff277e4..216bee45b90ce11de5f299c0fd75caa1f4fd363e 100644
--- a/doc/design-2.0-commandline-parameters.rst
+++ b/doc/design-2.0-commandline-parameters.rst
@@ -104,7 +104,7 @@ Disk Device Options
 
 The generic format of the disk device option is:
 
-  --disk $DEVNUM:[$OPTION=$VALUE][,$OPTION=VALUE]
+  --disk $DEVNUM[:$OPTION=$VALUE][,$OPTION=VALUE]
 
 :$DEVNUM: device number, unsigned integer, starting at 0,
 :$OPTION: device option, string,
@@ -260,4 +260,3 @@ The generic format of the hypervisor clusterwide default setting option is:
   to set, string
 :$OPTION: cluster default option, string,
 :$VALUE: cluster default option value, string.
-
diff --git a/doc/design-2.0-rapi-changes.rst b/doc/design-2.0-rapi-changes.rst
index 26f16575fa54eb7f1d3ed0ebf76d05a43ece8f4e..dce31bc38bedf4dfe1f3ebe23b4a05e39b4dd9fc 100644
--- a/doc/design-2.0-rapi-changes.rst
+++ b/doc/design-2.0-rapi-changes.rst
@@ -81,6 +81,7 @@ condition.
 
 Resource representation
 ~~~~~~~~~~~~~~~~~~~~~~~
+
 The key difference of REST approach from others API is instead having one URI
 for all our requests, REST demand separate service by resources with unique
 URI. Each of them should have limited amount of stateless and standard HTTP
@@ -110,7 +111,8 @@ operations.
 
 
 Security
-~~~~~~~~
+--------
+
 With the write functionality security becomes much bigger an issue.  The Ganeti
 RAPI uses basic HTTP authentication on top of SSL connection to grant access to
 an exported resource. The password stores locally in Apache-style .htpasswd