-This directory contains source for the project mandated "read the docs"
-.rst documentation. The Makefile will both build the doc from the source
-here and "install" it into the docs directory at the repo root. While
-it is not good practice, the generated .rst files must be checked into
-the repo and committed with changes to the source.
+This directory contains source for the project mandated "read the
+docs" .rst documentation. If the "tfm" tool is available, the
+Makefile will both build the doc from the source here and "install" it
+into the docs directory at the repo root. Then the generated .rst
+files must be checked into the repo and committed with changes to the
+source (maybe not the best practice).