Modified paragraph on documentation in README.md

README.md

@@ -284,9 +284,13 @@ The C header files can be included as follows:
 Documentation
 Documentation
 -------------
 -------------
 
 
-EMB² comes with a tutorial, example programs, and an HTML reference
-documentation describing the APIs, which can be found in the "doc" folder.
-The root document of the HTML reference is "doc/reference/index.html".
+The release files of EMB² come with a tutorial, example programs, and a
+reference manual (HTML) describing the APIs. All documentation is contained in
+the "doc" folder. The root document of the HTML reference is
+"doc/reference/index.html". Note that generated documentation files are not
+under version control and hence not contained in the repository. As mentioned
+above, it is therefore recommended to download one of the packaged release
+files in order to have ready-to-use documentation.
 
 
 
 
 Code Quality
 Code Quality