Update README

Add instructions on how to build the doxygen documentation

diff --git a/README.md b/README.md
index aeacb1a63e218e3829d3e129a6e9e79a0801b31a..d63ea5b2fe9f4f09a4b4f51373036a7b75822c21 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,2 +1,7 @@
 # code-gallery
-A collection of codes based on deal.II contributed by deal.II users
+A collection of codes based on [deal.II](https://www.dealii.org) contributed by `deal.II` users
+
+### Building the documentation
+
+To build the doxygen documentation, check out the code gallery git repository in a directory parallel to the `<path/to/deal.II>/examples/` directory, and then build the `deal.II` documentation as [described in the readme](https://www.dealii.org/developer/readme.html#documentation). 
+It will pick up the code gallery and create joint documentation for the tutorial and the code gallery.