Add logo, improve texts

docs/index.rst

@@ -1,12 +1,15 @@
-PlatformIO: A cross-platform code builder and library manager for Arduino, MSP430, ARM
-======================================================================================
+PlatformIO: A cross-platform code builder and the missing library manager
+=========================================================================
+
+.. image:: _static/platformio-logo.png
+    :target: http://platformio.ikravets.com
 
 `Website + Library Search <http://platformio.ikravets.com>`_ |
 `Project Examples <https://github.com/ivankravets/platformio/tree/develop/examples>`_ |
 `Source Code <https://github.com/ivankravets/platformio>`_ |
-`Bugs/Questions <https://github.com/ivankravets/platformio/issues>`_ |
+`Issues <https://github.com/ivankravets/platformio/issues>`_ |
 `Blog <http://www.ikravets.com/category/computer-life/platformio>`_ |
-`Twitter <https://twitter.com/smartanthill>`_
+`Twitter <https://twitter.com/PlatformIOTool>`_
 
 You have no need to install any *IDE* or compile any tool chains. *PlatformIO*
 has pre-built different development platforms including: compiler, debugger,
@@ -27,9 +30,7 @@ instruments.
 * Automatically analyse dependency
 * Reliably detect build changes
 * Build framework or library source code to static library
-* Build *ELF* (executable and linkable firmware)
-* Convert *ELF* to *HEX* or *BIN* file
-* Extract *EEPROM* data
+* Lookup for external libraries which are installed via :ref:`librarymanager`
 * Upload firmware to your device
 
 

docs/librarymanager/config.rst

@@ -4,18 +4,17 @@
 library.json
 ============
 
-*PlatformIO*-suitable library should be defined by a manifest file
-``library.json`` in a `JSON-style <http://en.wikipedia.org/wiki/JSON>`_.
-A data in ``library.json`` should be represented via
-`associative array <http://en.wikipedia.org/wiki/Associative_array>`_
-(name/value pairs). An order doesn't matter.
+``library.json`` is a manifest file of development library.
 
-The allowable fields (names from pairs) are described below. The fields
-(:ref:`libjson_name`, :ref:`libjson_description`, :ref:`libjson_keywords`
-and :ref:`libjson_authors`)
-will be displayed in the search results at the :ref:`cmd_lib_search` (*CLI*)
-and at the `WebSite <http://platformio.ikravets.com/#!/lib>`_.
-Also, they can be used for searching for libraries.
+Initially it was
+developed for :ref:`librarymanager`, but later was accepted by worldwide embedded
+community like a **standard library specification**.
+
+A data in ``library.json`` should be represented
+in `JSON-style <http://en.wikipedia.org/wiki/JSON>`_ via
+`associative array <http://en.wikipedia.org/wiki/Associative_array>`_
+(name/value pairs). An order doesn't matter. The allowable fields
+(names from pairs) are described below.
 
 .. contents::
 

docs/librarymanager/index.rst

@@ -17,8 +17,8 @@ You don't need to bother for finding the latest version of library. Due to
 .. toctree::
     :maxdepth: 2
 
-    creating
     config
+    creating
     User Guide <../userguide/lib/index.rst>
 
 .. [#] Inspired by `npm <https://www.npmjs.org>`_ and `bower

docs/quickstart.rst

@@ -3,6 +3,10 @@
 Quickstart
 ==========
 
+.. note::
+    Please read `Get Started <http://platformio.ikravets.com/#!/get-started>`_
+    article from the official WebSite.
+
 First, :ref:`Install PlatformIO <installation>`.
 
 Print all available development platforms for installing