opentraffic
diff --git a/‎README.md
+5 b/‎README.md
+5
diff --git a/‎docs/intro.md
+144 b/‎docs/intro.md
+144
diff --git a/‎docs/many_to_many.png
39.8 KB b/‎docs/many_to_many.png
39.8 KB
diff --git a/‎docs/many_to_many.svg
+268 b/‎docs/many_to_many.svg
+268
diff --git a/‎docs/many_to_one.png
29.3 KB b/‎docs/many_to_one.png
29.3 KB
diff --git a/‎docs/many_to_one.svg
+192 b/‎docs/many_to_one.svg
+192
diff --git a/‎docs/one_to_many.png
30.5 KB b/‎docs/one_to_many.png
30.5 KB
@@ -40,3 +40,8 @@ LD_LIBRARY_PATH=/usr/lib:/usr/local/lib osmlr /data/valhalla/tiles.tar
 
 #HAVE FUN!
 ```
+
+Documentation
+-------------
+
+You can find an [introduction](docs/intro.md) to OSMLR and the concepts behind it in the `docs/` directory. If there's something that you've found tricky to understand in OSMLR, then please open an [issue](https://github.com/opentraffic/osmlr/issues/new) and provide as much detail as possible. Or, even better, submit a [pull request with your improvements](https://github.com/opentraffic/osmlr/compare)!