diff --git a/docs/userguide/cmd_ci.rst b/docs/userguide/cmd_ci.rst
index a036d2e7..f5743bff 100644
--- a/docs/userguide/cmd_ci.rst
+++ b/docs/userguide/cmd_ci.rst
@@ -52,7 +52,7 @@ Options
 .. program:: platformio ci
 
 .. option::
-    --lib, -l
+    -l, --lib
 
 Source code which will be copied to ``%build_dir%/lib`` directly.
 
@@ -78,7 +78,7 @@ For example, exclude from project ``src`` directory:
     platformio ci --exclude=src/examples --exclude=src/foo/*.h [SRC]
 
 .. option::
-    --board, -b
+    -b, --board
 
 Build project with automatically pre-generated environments based on board
 settings.
diff --git a/docs/userguide/cmd_init.rst b/docs/userguide/cmd_init.rst
index d7c5170a..a84694ff 100644
--- a/docs/userguide/cmd_init.rst
+++ b/docs/userguide/cmd_init.rst
@@ -32,12 +32,12 @@ Options
 .. program:: platformio init
 
 .. option::
-    --project-dir, -d
+    -d, --project-dir
 
 A path to the directory where *PlatformIO* will initialise new project.
 
 .. option::
-    --board, -b
+    -b, --board
 
 If you specify board ``type`` (you can pass multiple ``--board`` options), then
 *PlatformIO* will automatically generate environment for :ref:`projectconf` and
@@ -53,7 +53,7 @@ The full list with pre-configured boards is available here :ref:`platforms`.
     --disable-auto-uploading
 
 If you initialise project with the specified
-:option:`platformio init --board``, then *PlatformIO*
+:option:`platformio init --board`, then *PlatformIO*
 will create environment with enabled firmware auto-uploading. This option
 allows you to disable firmware auto-uploading by default.