diff --git a/docs/faq.rst b/docs/faq.rst
index 9658ec74..05e995b4 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -79,6 +79,7 @@ Bash completion for `platformio` subcommands you need to put into your `.bashrc`
 .. code-block:: bash
 
     eval "$(_PLATFORMIO_COMPLETE=source platformio)"
+    eval "$(_PLATFORMIO_COMPLETE=source pio)"
 
 ZSH completion
 ''''''''''''''
@@ -89,6 +90,7 @@ To enable ``zsh`` completion please run these commands:
 
     autoload bashcompinit && bashcompinit
     eval "$(_PLATFORMIO_COMPLETE=source platformio)"
+    eval "$(_PLATFORMIO_COMPLETE=source pio)"
 
 .. note::
 
diff --git a/docs/ide/atom.rst b/docs/ide/atom.rst
index f0bf6bbc..11174f48 100644
--- a/docs/ide/atom.rst
+++ b/docs/ide/atom.rst
@@ -28,7 +28,7 @@ for IoT development:
 * C/C++ Intelligent code completion
 * C/C++ Smart code linter
 * Library Manager for the hundreds popular libraries
-* Built-in Terminal which allows to run PlatformIO CLI (``pio``, ``platformio``)
+* Built-in Terminal with :ref:`PlatformIO CLI <userguide>` (``pio``, ``platformio``)
 
 Atom is a source code editor that's modern, approachable,
 yet hackable to the core—a tool you can customize to do anything but also use
diff --git a/docs/userguide/index.rst b/docs/userguide/index.rst
index 7b4f8997..d447a775 100644
--- a/docs/userguide/index.rst
+++ b/docs/userguide/index.rst
@@ -22,6 +22,9 @@ Usage
 .. code-block:: bash
 
     platformio [OPTIONS] COMMAND
+    pio [OPTIONS] COMMAND
+
+    # "pio" is the alias of "platformio" command
 
 Options
 -------