Modified example and badges

Author: jacobtomlinson

README.md

@@ -1,78 +1,55 @@
-# _Datapoint for Python_
-[![PyPi version](https://pypip.in/v/datapoint/badge.svg?style=flat)](https://pypi.python.org/pypi/datapoint/)
-[![PyPi downloads](https://pypip.in/d/datapoint/badge.svg?style=flat)](https://pypi.python.org/pypi/datapoint/)
-[![Supported Python versions](https://pypip.in/py_versions/datapoint/badge.svg?style=flat)](https://pypi.python.org/pypi/datapoint/)
-[![Development Status](https://pypip.in/status/datapoint/badge.svg?style=flat)](https://pypi.python.org/pypi/datapoint/)
+# _DataPoint for Python_
+[![PyPi version](https://pypip.in/v/datapoint/badge.svg)](https://pypi.python.org/pypi/datapoint/)
+[![PyPi downloads](https://pypip.in/d/datapoint/badge.svg)](https://pypi.python.org/pypi/datapoint/)
+[![Supported Python versions](https://pypip.in/py_versions/datapoint/badge.svg)](https://pypi.python.org/pypi/datapoint/)
+[![Development Status](https://pypip.in/status/datapoint/badge.svg)](https://pypi.python.org/pypi/datapoint/)
 [![Build Status](https://travis-ci.org/jacobtomlinson/datapoint-python.svg?branch=master)](https://travis-ci.org/jacobtomlinson/datapoint-python)
 
 
 _A Python module for accessing weather data via the [Met Office](http://www.metoffice.gov.uk/)'s open data API
-known as [Datapoint](http://www.metoffice.gov.uk/datapoint)._
+known as [DataPoint](http://www.metoffice.gov.uk/datapoint)._
 
-__Disclaimer: This module is in no way part of the datapoint project/service.
-This module is intended to simplify the use of Datapoint for small Python projects (e.g school projects).
-No support for this module is provided by the Met Office and may break as the Datapoint service grows/evolves.
+__Disclaimer: This module is in no way part of the DataPoint project/service.
+This module is intended to simplify the use of DataPoint for small Python projects (e.g school projects).
+No support for this module is provided by the Met Office and may break as the DataPoint service grows/evolves.
 The author will make reasonable efforts to keep it up to date and fully featured.__
 
 ## Installation
 
 ```Bash
-$ pip install datapoint
+$ pip install DataPoint
 ```
 
-You will also require a [Datapoint API key](http://www.metoffice.gov.uk/datapoint/API).
+You will also require a [DataPoint API key](http://www.metoffice.gov.uk/datapoint/API).
 ## Example Usage
 
 ```Python
-#!/usr/bin/env python
-
 import datapoint
 
-conn = datapoint.Manager(api_key="aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
+# Create connection to DataPoint with your API key
+conn = datapoint.connection(api_key="aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
 
+# Get the nearest site for my longitude and latitude
 site = conn.get_nearest_site(-0.124626, 51.500728)
-print site.name
 
+# Get a forecast for my nearest site with 3 hourly timesteps
 forecast = conn.get_forecast_for_site(site.id, "3hourly")
 
-for day in forecast.days:
-    print "\n%s" % day.date
-    for timestep in day.timesteps:
-        print timestep.name
-        print timestep.weather.text
-        print "%s%s%s" % (timestep.temperature.value,
-                          u'\xb0', #Unicode character for degree symbol
-                          timestep.temperature.units)
+# Get the current timestep from the forecast
+current_timestep = forecast.now()
+
+# Print out the site and current weather
+print site.name, "-", current_timestep.weather.text
 
 ```
 
 Example output
 ```
-London
-
-2014-07-16Z
-360
-Sunny day
-16°C
-540
-Sunny day
-22°C
-720
-Partly cloudy (day)
-24°C
-900
-Cloudy
-26°C
-1080
-Cloudy
-25°C
-1260
-Partly cloudy (night)
-23°C
-
-...
+London - Heavy rain
 ```
 
+See [examples directory](https://github.com/jacobtomlinson/datapoint-python/tree/master/examples) for more in depth examples.
+
 ## Features
  * List forecast sites
  * Get nearest forecast site from longitude and latitiude
@@ -86,4 +63,4 @@ Please feel free to submit issues and pull requests.
 
 ## License
 
-Currently under decision. 
+Currently under decision.