added docker doc with command samples

docs/developers/docker_guide.md

@@ -0,0 +1,125 @@
+---
+parent: Developers
+---
+
+# Docker help
+
+In addition to the intro in readme.md about Docker, here are a few commands for daily work with the system.
+
+Build the Docker with a version based name
+```
+$ docker build -t brouter-1.7.2 .
+```
+
+Start Docker with name additional to the Docker image name.
+Please note:
+The path for segments are on a Windows system.
+Here the port used in server.sh is published.
+```
+$ docker run --rm -v "I:/Data/test/segment4":/segments4 --publish 17777:17777 --name brouter-1.7.2 brouter-1.7.2
+```
+
+and with a mount for profiles as well
+```
+$ docker run --rm -v "I:/Data/test/segment4":/segments4 -v "I:/Data/test/profiles2":/profiles2 --name brouter-1.7.2 brouter-1.7.2
+```
+
+Show the running Docker processes
+```
+$ docker ps
+
+output:
+CONTAINER ID   IMAGE           COMMAND                  CREATED         STATUS         PORTS                      NAMES
+b23518e8791d   brouter-1.7.2   "/bin/sh -c /bin/ser…"   5 minutes ago   Up 5 minutes   0.0.0.0:17777->17777/tcp   brouter-1.7.2
+```
+
+Fire some curl or wget commands to test if is realy useful running.
+
+Stop a running Docker image - please note, this only works when starts docker image with name, see above
+```
+$ docker stop brouter-1.7.2
+```
+
+Docker available images
+
+```
+$ docker images
+
+output:
+REPOSITORY                     TAG                                        IMAGE ID       CREATED              SIZE
+brouter-1.7.2                  latest                                     e39703dec2fa   2 hours ago          410MB
+brouter                        latest                                     728f122c7388   3 hours ago          410MB
+```
+
+Control
+## Docker with docker-compose
+
+Use a git clone to build a local folder with last version.
+Make a Docker container with version number inside your repository folder.
+```
+$ docker build -t brouter:1.7.2 .
+
+$ docker images
+
+REPOSITORY                     TAG                                        IMAGE ID       CREATED          SIZE
+brouter-1.7.2                  latest                                     e39703dec2fa   3 hours ago      410MB
+brouter                        1.7.2                                      e39703dec2fa   3 hours ago      410MB
+```
+
+Start a container with composer
+This needs a docker config file docker-compose.yml
+Something like this:
+```
+version: '2'
+services:
+  brouter:
+    image: brouter:1.7.2
+    restart: unless-stopped
+    ports:
+      - 17777:17777
+    volumes:
+      - type: bind
+        source: "I:/Data/test/segment4"
+        target: /segments4
+#      - type: bind
+#        source: "I:/Data/test/profiles2"
+#        target: /profiles2
+```
+
+Start it
+```
+$ docker-compose up -d
+```
+
+Have a look what is running
+```
+$ docker-compose ps
+or
+$ docker-compose ls
+or
+$ docker ps
+```
+
+
+Now update your repository (git pull) and build your Docker container with the new version tag
+```
+$ docker build -t brouter:1.7.3 .
+
+$ docker images
+
+REPOSITORY                     TAG                                        IMAGE ID       CREATED         SIZE
+brouter                        1.7.3                                      5edc998cb5ae   3 hours ago     410MB
+brouter-1.7.2                  latest                                     e39703dec2fa   6 hours ago     410MB
+```
+
+Replace the version in Docker config file docker-compose.yml
+```
+    image: brouter:1.7.3
+```
+
+Stop old running container and start the new one
+```
+$ docker-compose down
+
+$ docker-compose up -d
+```

docs/users/osmand.md

@@ -67,3 +67,29 @@ application profiles"/>
 The BRouter app should be launched before OsmAnd for this specific entry to
 appear in OsmAnd. Therefore, if you cannot find "BRouter (offline)" navigation
 option, you should force quit OsmAnd and restart it.
+
+
+## OsmAnd version 4.7.1
+
+From version 4.7.1 upwards Osmand supports the profile parameter for mapping:
+Since Osmand version 3, many profiles can be defined in Osmand and the user can easily switch between these profiles.
+This allow now when using the service-interface to address different brouter-profiles in a more flexible and better comprehensive way.
+
+- If in Osmand a profile has "BRouter" defined as navigation service
+- AND the profile-name looks like "Brouter[mysting]
+
+==> then the profile "mystring" will be used in the Brouter-app!
+(this new mapping replaces in that case the basic mapping defined above and based on the file "serviceconfig.dat)
+
+### Examples: Osmand-profile name	Brouter-app
+```
+[Brouter[trekking]	"trekking" profile will be used (file trekking.brf)
+[Brouter[racebike]	"racebike" profile will be used (file racebike.brf)
+....
+```
+Remark:
+Currently Osmand do not check the defined name (case sensitiv) for the Brouter-profile (mystring).
+If no profile is found, the routing will fail with "Could not calculate route.."!
+
+<img src="osmand/brouter-osmand-4.7.1.png" alt="BRouter configuration in OsmAnd
+application profiles"/>