diff --git a/README.md b/README.md
index 645829d..0cf0406 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,46 @@
-# OSM Liberty
+# OSM Liberty [](https://github.com/lukasmartinelli/osm-liberty/blob/gh-pages/LICENSE.md)
A fork of OSM Bright based on free data sources with a mission for a clear good looking design for the
everyday user.
+**[osm-liberty.lukasmartinelli.ch](http://osm-liberty.lukasmartinelli.ch/)**
+
+## Usage
+
+You can instantly use the style in your Mapbox GL maps. The vector tiles are served from the @klokantech public CDN
+and the raster tiles, glyphs and sprites directly from GitHub.
+Take a look at the [demo page source code](index.html) how to display a map.
+To use it you don't need any access keys and you can host the tiles and assets yourself for complete liberty.
+
+```html
+
+
+
+
+ OSM Liberty
+
+
+
+
+
+
+
+
+
+
+```
+
## Data Sources
- [OSM2VectorTiles](http://osm2vectortiles.org/) as vector data source
@@ -11,14 +49,18 @@ everyday user.
## Map Design
-The map design originates from OSM Bright but strives to reach the clean design and elegance of Google Maps.
-Colored relief shading from Natural Earth makes the low zoom levels look good.
+The map design originates from OSM Bright but strives to reach a unobtrusive and clean design for everyday use.
+Colored relief shading from Natural Earth make the low zoom levels look good.
+**Modify Style**
+
+You can directly modify the style with the help of the [mapbox-gl-style-editor](https://github.com/erikandre/mapbox-gl-style-editor).
+
## Icon Design
A [Maki](https://github.com/mapbox/maki) icon set using colors to distinguish between icon categories.
@@ -39,5 +81,3 @@ Green | `#76a723`
1. Take the style JSON file and upload it to the [Maki Editor]().
2. Apply your changes and download the icon set again.
3. Ensure you format the JSON first with `cat iconset.json | jq -MS '.'`
-
-## License