diff --git a/doc/README.md b/doc/README.md
index 9e793f00..a7e03f5a 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -3,6 +3,9 @@ The official Swiss Ephemeris is found at https://www.astro.com/ftp/swisseph/doc/
 
 The documentation on Github is in an experimental stage.
 
-are in process of moving from MS-Word files to Markdown files for the documentation, but
-the transition is far from complete.
+We are in process of moving from MS-Word files to Markdown files for easier maintenance 
+of the documentation, but the transition is far from complete.
+
+The PDF and HTM files you find in this directory have been automatically created
+out of the .md files. See makefile for details of this process.