Merge branch 'jean-master'

README.rst

 Introduction
 ============
 
-Fastkml is a library to read, write and manipulate kml files. It aims to keep
+Fastkml is a library to read, write and manipulate KML files. It aims to keep
 it simple and fast (using lxml_ if available). Fast refers to the time you
 spend to write and read KML files as well as the time you spend to get
 aquainted to the library or to create KML objects. It aims to provide all of
@@ -9,7 +9,8 @@ the functionality that KML clients such as `OpenLayers
 <http://openlayers.org/>`_, `Google Maps <http://maps.google.com/>`_, and
 `Google Earth <http://earth.google.com/>`_ provides.
 
-Geometries are handled as pygeoif_ or shapely_ (if installed) objects.
+
+Geometries are handled as pygeoif_ or, if installed, shapely_ objects.
 
 .. _pygeoif: http://pypi.python.org/pypi/pygeoif/
 .. _shapely: http://pypi.python.org/pypi/Shapely
@@ -21,9 +22,11 @@ Fastkml is continually tested with *Travis CI*:
 
 .. image:: https://api.travis-ci.org/cleder/fastkml.png
     :target: https://travis-ci.org/cleder/fastkml
+    :alt: Tests
 
 .. image:: https://coveralls.io/repos/cleder/fastkml/badge.png?branch=master
     :target: https://coveralls.io/r/cleder/fastkml?branch=master
+    :alt: Coverage
 
 
 Is Maintained and documented:
@@ -38,6 +41,7 @@ Is Maintained and documented:
 
 .. image:: https://readthedocs.org/projects/fastkml/badge/
     :target: https://fastkml.readthedocs.org/
+    :alt: Documentation
 
 .. image:: https://badge.waffle.io/cleder/fastkml.png?label=ready&title=Ready
     :target: https://waffle.io/cleder/fastkml
@@ -100,7 +104,7 @@ Limitations
 ===========
 
 *Tesselate*, *Extrude* and *Altitude Mode* are assigned to a Geometry or
-Geometry collection (MultiGeometry). You cannot assign diffrent values of
+Geometry collection (MultiGeometry). You cannot assign different values of
 *Tesselate*, *Extrude* or *Altitude Mode* on parts of a MultiGeometry.
 
 Currently, the only major feature missing for the full Google Earth experience

docs/contributing.rst

@@ -17,7 +17,7 @@ Pull Requests
 
 Start by submitting a pull request on GitHub against the `master` branch of the
 repository. Your pull request should provide a good description of the change
-you are making and or the bug that you are fixing. This will then trigger a
+you are making, and/or the bug that you are fixing. This will then trigger a
 build in `Travis-CI`_ where your contribution will be tested to verify it does
 not break existing functionality.
 

docs/index.rst

@@ -36,10 +36,10 @@ Supports python 2 and 3:
     :target: https://pypi.python.org/pypi/fastkml/
     :alt: Supported Python implementations
 
-Fastkml is a library to read, write and manipulate kml files. It aims to keep
+fastkml is a library to read, write and manipulate KML files. It aims to keep
 it simple and fast (using lxml_ if available). "Fast" refers to the time you
-spend to write and read KML files as well as the time you spend to get
-aquainted to the library or to create KML objects. It provides a subset of KML
+spend to write and read KML files, as well as the time you spend to get
+acquainted with the library or to create KML objects. It provides a subset of KML
 and is aimed at documents that can be read from multiple clients such as
 openlayers and google maps rather than to give you all functionality that KML
 on google earth provides.
@@ -51,18 +51,18 @@ developers site.
 Rationale
 ---------
 
-Why yet another KML library? None of the existing ones quite fitted my
+Why yet another KML library? None of the existing ones quite fit my
 requirements, namely:
 
-* Fastkml can *read and write* KML files, feeding fastkmls output back into
+* fastkml can *read and write* KML files, feeding fastkml's output back into
   fastkml and serializing it again will result in the same output.
-* You can parse any kml snipppet, it does not need to be a complete KML
+* You can parse any KML snippet, it does not need to be a complete KML
   document.
-* It runs on python 2 and 3.
+* It runs on Python 2 and 3.
 * It is fully tested and actively maintained.
 * Geometries are handled in the `__geo_interface__` standard.
-* Minimal dependencies, pure python.
-* If available lxml_ will be used to increase its speed.
+* Minimal dependencies, pure Python.
+* If available, lxml_ will be used to increase its speed.
 
 .. toctree::
    :maxdepth: 2

docs/installing.rst

@@ -13,7 +13,7 @@ fastkml works on Unix/Linux, OS X, and Windows.
 
 Install it with ``pip install fastkml`` or ``easy_install fastkml``.
 
-If you use fastkml extensively or need to process big kml files consider
+If you use fastkml extensively or need to process big KML files, consider
 installing lxml_ as it speeds up processing.
 
 You can install all requirements for working with fastkml by using pip_ from

docs/usage_guide.rst

 Usage Guide
 ===========
 
-
 You can find more examples in the included ``test_main.py`` file or in
 collective.geo.fastkml_, here is a quick overview: