Fix responsive images and use klokan tileserver in own vector tile sample

_sass/_base.scss

@@ -106,4 +106,9 @@ article, .article{
     margin-left: auto;
     margin-right: auto;
   }
-}
+}
+
+/* responsive images */
+img {
+    max-width: 100%;
+}

docs/index.md

@@ -21,15 +21,15 @@ Get started styling and using vector tiles.
 
 ## Developer Documentation
 
-Documentation about the internals of the project targeted at people
+Documentation about how to create vector tiles yourself.
-who want to reuse part of our process or want to contribute.
+Targeted at people who want to reuse our process or want to contribute.
 
+- Vector Tiles
+  - [Create your own Vector Tiles](/docs/own-vector-tiles)
+  - [Layer Reference](/docs/layer-reference)
+  - [Create your own Extract](/docs/extracts)
 - Data Source
   - [Data Sources of OSM Vector Tiles](/docs/data-sources)
-- Vector Tiles
-  - [Create your own vector tiles](/docs/own-vector-tiles)
-  - [Layer Reference](/docs/layer-reference)
-  - [Create your own extract](/docs/extracts)
 - Import and Export
   - [Import and Export Process](/docs/import-export-process)
   - [Imposm Mapping Schema](/docs/imposm-schema)

docs/own-vector-tiles.md

@@ -1,14 +1,15 @@
 ---
 layout: page
-title: Own Vector Tiles
+title: Create your own Vector Tiles
 published: true
 ---
 
 # Create your own vector tiles
 
-We use Docker extensively for development and deployment. The easiest way to get started is using [Docker Compose](https://www.docker.com/docker-compose).
+We use Docker extensively for development and deployment.
+The easiest way to get started is using [Docker Compose](https://www.docker.com/docker-compose).
 
-Clone the osm2vectortiles project.
+Clone the [osm2vectortiles](https://github.com/osm2vectortiles/osm2vectortiles) project.
 
 ```
 git clone https://github.com/osm2vectortiles/osm2vectortiles.git
@@ -21,6 +22,8 @@ docker-compose up -d postgis
 ```
 
 Download a PBF and put it into the local `import` directory.
+You can use extracts from [Mapzen](https://mapzen.com/data/metro-extracts)
+or [Geofabrik](http://download.geofabrik.de/)
 
 ```
 wget https://s3.amazonaws.com/metro-extracts.mapzen.com/zurich_switzerland.osm.pbf
@@ -33,15 +36,13 @@ docker-compose up import-osm
 ```
 
 Now you need to import several external data sources.
-
 Import water polygons from [OpenStreetMapData.com](http://openstreetmapdata.com/data/water-polygons).
 
-
 ```
 docker-compose up import-water
 ```
 
-Import Natural Earth data for lower zoom levels.
+Import [Natural Earth](http://www.naturalearthdata.com/) data for lower zoom levels.
 
 ```
 docker-compose up import-natural-earth
@@ -53,13 +54,13 @@ Import custom country, sea and state labels.
 docker-compose up import-labels
 ```
 
-Now import custom SQL functions.
+Now import custom SQL functions used in the source project.
 
 ```
 docker-compose up import-sql
 ```
 
-Update the scaleranks of OSM places.
+Update the scaleranks of OSM places with data from Natural Earth.
 
 ```
 docker-compose up update-scaleranks
@@ -77,13 +78,19 @@ Serve the tiles as raster tiles from `export` directory.
 docker-compose up serve
 ```
 
+The tile server will no be visible on the docker host on port `8080`.
+You can now see extract rendered as `Open Streets v1.0` and if you have
+style projects in your directory the rendered raster map as well.
+
+![Tessera Overview](/media/local_serve_container_tessera_overview.png)
+
 ## Docker Images
 
 The workflow consists of several prebuilt Docker images.
 
 | Image                             | Size                                                                                                               |
 | --------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
-| osm2vectortiles/serve             | [![ImageLayers Size](https://img.shields.io/imagelayers/image-size/osm2vectortiles/serve/latest.svg)]()            |
+| klokantech/tileserver-mapnik      | [![ImageLayers Size](https://img.shields.io/imagelayers/image-size/klokantech/tileserver-mapnik/latest.svg)]()            |
 | osm2vectortiles/export            | [![ImageLayers Size](https://img.shields.io/imagelayers/image-size/osm2vectortiles/export/latest.svg)]()           |
 | osm2vectortiles/import-external   | [![ImageLayers Size](https://img.shields.io/imagelayers/image-size/osm2vectortiles/import-external/latest.svg)]()  |
 | osm2vectortiles/import-sql        | [![ImageLayers Size](https://img.shields.io/imagelayers/image-size/osm2vectortiles/import-sql/latest.svg)]()       |