Add "pio" alias to docs // Resolve #447

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::
 

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

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
 -------