PlatformIO is an open source ecosystem for IoT development

README.rst

@@ -42,9 +42,20 @@ PlatformIO
 .. image:: https://raw.githubusercontent.com/platformio/platformio/develop/docs/_static/platformio-logo.png
     :target: http://platformio.org
 
-`PlatformIO <http://platformio.org>`_ is an open-source cross-platform code
+`PlatformIO <http://platformio.org>`_ is an open source ecosystem for IoT
-builder and library manager.  For embedded development, IDE
+development. Cross-platform, IDE and Continuous integration, Arduino and MBED
-and Continuous integration.  Arduino and MBED compatible.
+compatible. Ready for Cloud compiling.
+
+* **Development Platforms** - Embedded and Desktop development platforms with
+  pre-built toolchains, debuggers, uploaders and frameworks which work under
+  popular host OS: Mac, Windows, Linux (+ARM)
+* **Embedded Boards** - Rapid Embedded Programming, IDE and Continuous
+  Integration in a few steps with PlatformIO thanks to built-in project
+  generator for the most popular embedded boards and IDE
+* **Library Manager** - Hundreds Popular Libraries are organized into single
+  Web 2.0 platform: list by categories, keywords, authors, compatible
+  platforms and frameworks; learn via examples; be up-to-date with the latest
+  version
 
 *Atmel AVR & SAM, Espressif, Freescale Kinetis, Nordic nRF51, NXP LPC,
 Silicon Labs EFM32, ST STM32, TI MSP430 & Tiva, Teensy, Arduino, mbed,
@@ -66,11 +77,6 @@ libOpenCM3, etc.*
 * `FAQ <http://docs.platformio.org/en/latest/faq.html>`_
 * `Release History <http://docs.platformio.org/en/latest/history.html>`_
 
-You have **no need** to install any *IDE* or compile any toolchains. *PlatformIO*
-has pre-built development platforms and pre-configured settings for
-the most popular embedded boards. For further details, please
-refer to `What is PlatformIO? <http://docs.platformio.org/en/latest/faq.html#what-is-platformio>`_
-
 Use whenever. *Run everywhere.*
 -------------------------------
 *PlatformIO* is written in pure *Python* and **doesn't depend** on any
@@ -88,7 +94,7 @@ settings for most popular `Embedded Boards <http://platformio.org/#!/boards>`_.
 * Colourful `command-line output <https://raw.githubusercontent.com/platformio/platformio/develop/examples/platformio-examples.png>`_
 * `IDE Integration <http://docs.platformio.org/en/latest/ide.html>`_ with
   *Arduino, Eclipse, Energia, Qt Creator, Sublime Text, Vim, Visual Studio*
-* `Continuous Integration <http://docs.platformio.org/en/latest/ci/index.html>`_
+* Cloud compiling and `Continuous Integration <http://docs.platformio.org/en/latest/ci/index.html>`_
   with *AppVeyor, Circle CI, Drone, Shippable, Travis CI*
 * Built-in `Serial Port Monitor <http://docs.platformio.org/en/latest/userguide/cmd_serialports.html#platformio-serialports-monitor>`_ and configurable
   `build -flags/-options <http://docs.platformio.org/en/latest/projectconf.html#build-flags>`_
@@ -166,6 +172,7 @@ Frameworks:
 * `SPL <http://platformio.org/#!/frameworks/spl>`_
 * `mbed <http://platformio.org/#!/frameworks/mbed>`_
 
+For further details, please refer to `What is PlatformIO? <http://docs.platformio.org/en/latest/faq.html#what-is-platformio>`_
 
 Licence
 -------

docs/faq.rst

@@ -24,8 +24,8 @@ General
 What is PlatformIO?
 ~~~~~~~~~~~~~~~~~~~
 
-`PlatformIO <http://platformio.org>`_ is an open-source cross-platform code
+`PlatformIO <http://platformio.org>`_ is an open source ecosystem for IoT
-builder and the missing library manager.
+development.
 
 PlatformIO is independent from the platform, in which it is running. In fact,
 the only requirement is Python, which exists pretty much everywhere. What this

docs/index.rst

@@ -9,15 +9,26 @@
     See the License for the specific language governing permissions and
     limitations under the License.
 
-PlatformIO is an open-source cross-platform code builder and the missing library manager
+PlatformIO is an open source ecosystem for IoT development
-========================================================================================
+==========================================================
 
-**Ready for embedded development, IDE and Continuous integration, Arduino and
+**Cross-platform, IDE and Continuous integration, Arduino and MBED
-MBED compatible**
+compatible. Ready for Cloud compiling.**
+
+* **Development Platforms** - Embedded and Desktop development platforms with
+  pre-built toolchains, debuggers, uploaders and frameworks which work under
+  popular host OS: Mac, Windows, Linux (+ARM)
+* **Embedded Boards** - Rapid Embedded Programming, IDE and Continuous
+  Integration in a few steps with PlatformIO thanks to built-in project
+  generator for the most popular embedded boards and IDE
+* **Library Manager** - Hundreds Popular Libraries are organized into single
+  Web 2.0 platform: list by categories, keywords, authors, compatible
+  platforms and frameworks; learn via examples; be up-to-date with the latest
+  version
 
 *Atmel AVR & SAM, Espressif, Freescale Kinetis, Nordic nRF51, NXP LPC,
 Silicon Labs EFM32, ST STM32, TI MSP430 & Tiva, Teensy, Arduino, mbed,
-libOpenCM3, etc.*
+libOpenCM3, etc.**
 
 * `Website <http://platformio.org>`_
 * `Web 2.0 Library Search <http://platformio.org/#!/lib>`_ |
@@ -31,18 +42,13 @@ libOpenCM3, etc.*
   `Facebook <https://www.facebook.com/platformio>`_ |
   `Reddit <http://www.reddit.com/r/platformio/>`_
 
-You have **no need** to install any *IDE* or compile any tool chains. *PlatformIO*
-has pre-built different development platforms and pre-configured settings for
-the most popular embedded boards. For further details, please
-refer to :ref:`faq_what_is_platformio`
-
 Embedded Development. *Easier Than Ever.*
 -----------------------------------------
 
 * Colourful command-line output
 * :ref:`IDE Integration <ide>` with *Arduino, Eclipse, Energia, Qt Creator,
   Sublime Text, Vim, Visual Studio*
-* :ref:`ci` with *AppVeyor, Circle CI, Drone, Shippable, Travis CI*
+* Cloud compiling and  :ref:`ci` with *AppVeyor, Circle CI, Drone, Shippable, Travis CI*
 * Built-in :ref:`Serial Port Monitor <cmd_serialports_monitor>` and
   configurable build :ref:`-flags/-options <projectconf_build_flags>`
 * Pre-built tool chains, :ref:`frameworks` for the
@@ -65,6 +71,7 @@ The Missing Library Manager. *It's here!*
 * Automatic library updating
 * It runs on Windows, Mac OS X, and Linux (+ARM).
 
+For further details, please refer to :ref:`faq_what_is_platformio`
 
 Contents
 --------

platformio/__init__.py

@@ -17,9 +17,9 @@ __version__ = ".".join([str(s) for s in VERSION])
 
 __title__ = "platformio"
 __description__ = (
-    "An open-source cross-platform code builder and the missing library "
+    "An open source ecosystem for IoT development. Cross-platform, IDE and "
-    "manager (Ready for embedded development, IDE and Continuous integration, "
+    "Continuous integration, Arduino and MBED compatible. "
-    "Arduino and MBED compatible)"
+    "Ready for Cloud compiling"
 )
 __url__ = "http://platformio.org"
 

setup.py

@@ -72,7 +72,7 @@ setup(
         "Topic :: Software Development :: Compilers"
     ],
     keywords=(
-        "builder library manager embedded development ide continuous "
+        "iot builder library manager embedded development ide continuous "
         "integration atmel avr sam espressif esp freescale kinetis nordic "
         "nrf51 nxp lpc silicon labs efm32 st stm32 ti msp430 tiva teensy "
         "arduino mbed libopencm3"