diff --git a/COAST/README.md b/COAST/README.md
index 215d5f10c3e772fedab9d81ff03e8bb325722f30..634854a199e9788ad6e5606fe2a53fdbde6522eb 100644
--- a/COAST/README.md
+++ b/COAST/README.md
@@ -1,7 +1,14 @@
+# COAST interface {#COASTinterface}
+
+With the COAST interface of CORSIKA 8 you can write a CORSIKA 8
+"process" class and link it to CORSIKA 7. This can be very powerful to
+benchmark new CORSIKA 8 physics code in the context of "old" CORSIKA 7
+simulations. 
+
 This is based on corsika7/trunk/coast/CoastOptions/example with an
-additional interface to CORSIKA8. 
+additional interface to CORSIKA 8. 
 
-This is an example for a "COAST user library" using CORSIKA8
+We provide a step-by-step example for a "COAST user library" using CORSIKA 8
 technology. It explains the steps, how to use the COAST_USER_LIB
 option of CORSIKA together with CORSIKA8/COAST
 
diff --git a/Documentation/Doxygen/Doxyfile.in b/Documentation/Doxygen/Doxyfile.in
index 47bcf61eb06572fab45ea308f3bf9091bbae512f..4606124def0d17e2d212321b379798039e06524a 100644
--- a/Documentation/Doxygen/Doxyfile.in
+++ b/Documentation/Doxygen/Doxyfile.in
@@ -8,7 +8,7 @@ EXCLUDE_PATTERNS       = */ThirdParty/*/*
 GENERATE_HTML          = YES
 GENERATE_LATEX         = YES
 
-FILE_PATTERNS          = *.cc *.cpp *.cxx *.h *.dox *.inc
+FILE_PATTERNS          = *.cc *.cpp *.cxx *.h *.dox *.inc *.md
 EXTENSION_MAPPING      = inc=C++
 RECURSIVE              = YES