Documentation edits to README.md

Proposed edits to increase user readability and ease of use of the README page.

README.md

@@ -1,37 +1,40 @@
 ~~~~
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-micropython-lib is highly experimental community project.
+micropython-lib is a "highly experimental" community project.
 
-Please help to drive it to just "expiremental" state by testing
+Please help to drive it to just "experimental" state by testing
 provided packages with MicroPython.
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 ~~~~
 
 micropython-lib
 ===============
-micropython-lib is a project to develop non-monolothic standard library
+micropython-lib is a project to develop a non-monolothic standard library
-for MicroPython. Each module or package is available as a seprate
+for MicroPython. Each module or package is available as a separate
-distribution package from PyPI. Modules either written from scratch or
+distribution package from PyPI. Each module is either written from scratch or
-ported from CPython. Note that main target of micropython-lib is so
+ported from CPython. 
-far "Unix" port of MicroPython. Actual requirements vary per module
+
-(basicly, if module is not related to I/O, it should work without
+Note that the main target of micropython-lib is a "Unix" port of MicroPython
-problem on baremetal ports too).
+(future ports to be determined). Actual system requirements vary per module.
+Though if a module is not related to I/O, the module should work without
+problem on bare-metal ports too.
+
 
 Usage
 -----
 micropython-lib packages are published on PyPI (Python Package Index),
-standard Python community package repository: http://pypi.python.org/ .
+the standard Python community package repository: http://pypi.python.org/ .
-You can search for MicroPython related packages, read additional info,
+On PyPi, you can search for MicroPython related packages and read
-etc.
+additional package information.
 
-To install packages from PyPI for usage on your local system, use
+To install packages from PyPI for usage on your local system, use the
-"pip-micropython" tool, which is a simple wrapper around a standard
+`pip-micropython` tool, which is a simple wrapper around the standard
-"pip" tool, which is used to install package for CPython.
+`pip` tool, which is used to install packages for CPython.
-"pip-micropython" tool can be found in "tools" subdirectory of the main
+The `pip-micropython` tool can be found in `tools` subdirectory 
-MicroPython repository (https://github.com/micropython/micropython).
+of the main MicroPython repository (https://github.com/micropython/micropython).
-Just install "pip-micropython" script somewhere on your PATH.
+Just install the `pip-micropython` script somewhere on your `PATH`.
 
-Afterwards, just use pip-micropython in a way similar to pip:
+Afterwards, just use `pip-micropython` in a way similar to `pip`:
 
 ~~~~
 $ pip-micropython install micropython-copy
@@ -41,21 +44,23 @@ $ micropython
 [1, 2, 3]
 ~~~~
 
-Review pip-micropython source code for more info.
+Review the `pip-micropython` source code for more info.
+
 
 Development
 -----------
-To install modules during development, use "make install". By default, it
+To install modules during development, use `make install`. By default, all
-will install all available packages. You can pass MOD=<module> parameter
+available packages will be installed. To install a specific module, add the 
-to install specific module.
+`MOD=<module>` parameter to the end of the `make install` command.
+
 
 Links
 -----
-More info:
+More information is on GitHub and in the MicroPython forums:
 
  * https://github.com/micropython/micropython/issues/405
  * http://forum.micropython.org/viewtopic.php?f=5&t=70
 
-Basic guidelines for installing packages from PyPI:
+For basic guidelines for installing packages from PyPI:
 
  * https://github.com/micropython/micropython/issues/413