#36 more detail on Docker in docs

geopython · Jun 17, 2016 · a9b778f · a9b778f
1 parent d14ba27
commit a9b778f
Show file tree

Hide file tree

Showing 6 changed files with 14 additions and 16 deletions.
diff --git a/docker/README.md b/docker/README.md
@@ -1,6 +1,7 @@
 # Stetl Docker
 
-Docker image to run ETL tool Stetl. See www.stetl.org.
+Docker image to run ETL tool Stetl. See http://stetl.org.
+Public Docker images are available at: https://hub.docker.com/r/justb4/stetl/.
 
 ## Status
 

diff --git a/docs/cases.rst b/docs/cases.rst
@@ -82,6 +82,7 @@ Smart Emission
 --------------
 
 Sensors for air quality, meteo and audio  at civilians. Project by University of Nijmegen/Gemeente Nijmegen with participation
-by Geonovum. Stetl used to transform a low-level sensor API to PostGIS and later on WMS/WFS/SOS.
+by Geonovum. Stetl is used to transform a low-level sensor API to PostGIS and later on WMS/WFS/SOS.
+This is also an example how to use a Stetl Docker image:
 
 See https://github.com/Geonovum/smartemission/tree/master/etl
diff --git a/docs/conf.py b/docs/conf.py
@@ -52,9 +52,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = '1.0.7rc7'
+version = '1.0.9'
 # The full version, including alpha/beta/rc tags.
-release = '1.0.7rc7'
+release = '1.0.9'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

diff --git a/docs/index.rst b/docs/index.rst
@@ -16,6 +16,7 @@ The code is on GitHub: https://github.com/justb4/stetl.
 
 See an `introductory Stetl presentation at Slideshare <http://www.slideshare.net/justb4/stetl-foss4g20131024v1>`_.
 
+This is document version |release| generated on |today|.
 
 Contents:
 

diff --git a/docs/install.rst b/docs/install.rst
@@ -134,20 +134,14 @@ Look for any error messages in your output.
 Install with Docker
 -------------------
 
-One of the cleanest ways to use Stetl is via Docker. Offcourse your environment needs to be
-setup to use Docker and probably you need some tooling like Vagrant. The author uses
+One of the cleanest ways to use Stetl is via `Docker <http://docker.com>`_. Your environment needs to be
+setup to use Docker and probably you want to use some tooling like `Vagrant <https://www.vagrantup.com/>`_. The author uses
 a combination of VirtualBox with Ubuntu and Vagrant on Mac OSX to run Docker, but this
-is a bit out of the scope here.
+is a bit out of scope here.
 
-Assuming you have a Docker environment, there are two ways to use Stetl with Docker:
+Assuming you have a working Docker environment, there are two ways to install Stetl with Docker:
 
 * build a Docker image yourself using the Dockerfile in https://github.com/justb4/stetl/tree/master/docker
 * use a prebuilt public Stetl Docker image: https://hub.docker.com/r/justb4/stetl
 
-
-
-
-
-
-
-
+For running Stetl using Docker see  :ref:`run_docker`.
diff --git a/docs/using.rst b/docs/using.rst
@@ -171,6 +171,8 @@ whatever it gets as input from the previous Filter in the Chain. ::
 		output/gmlcities.shp
 		temp/gmlcities.gml
 
+.. _run_docker:
+
 Using Docker
 ~~~~~~~~~~~~
 
@@ -181,7 +183,6 @@ https://github.com/Geonovum/smartemission/tree/master/etl.
 In the simplest case you run a Stetl Docker container from your own built image or the Dockerhub-provided
 one, `justb4/stetl:latest <https://hub.docker.com/r/justb4/stetl>`_ basically as follows:  ::
 
-
 	sudo docker run -v <host dir>:<container dir> -w <work dir> justb4/stetl:latest <any Stetl arguments>
 
 For example within the current directory you may have an ``etl.cfg`` Stetl file: ::