diff --git a/README.md b/README.md
index 651afbc1..2b52357e 100644
--- a/README.md
+++ b/README.md
@@ -11,15 +11,10 @@ It is made of two components:
    map rendering jobs.
    The rendering is done in the background by a daemon process.
 
- * OCitysMap (separate repository): the back-end that generates the map.
-   It is available as a Python module, used both by the maposmatic daemon
-   (above) and by a sample command line application.
-
-This source tree contains maposmatic, the web front-end.
-
-The OCitysMap repository can be found here:
-
-https://github.com/hholzgra/ocitysmap
+ * [OCitysMap](https://github.com/hholzgra/ocitysmap): the back-end 
+   that generates the map. It is available as a Python module, used 
+   both by the maposmatic daemon (above) and by a sample command 
+   line application.
 
 It is licensed under under GNU AGPLv3
 (GNU Affero General Public License 3.0).
@@ -34,11 +29,11 @@ https://translate.get-map.org/projects/maposmatic/maposmatic/
 Installation
 ------------
 
-Please refer to the ``INSTALL.md`` file in this repository.
+Please refer to the [``INSTALL``](INSTALL.md) file in this repository.
 
 End user and API documentation
 ------------------------------
 
 End user documentation for the web frontends useage, and API documentation
 for developers who want to submit their own rendering job into the rendering
-daemons queue, can be found in the ``documentation`` subdirectory.
\ No newline at end of file
+daemons queue, can be found in the [``documentation``](documentation) subdirectory.