diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 9e0d24627..fb864529b 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1197,6 +1197,9 @@ tools/generatejournal 3 5 5 --mixed >examples/mixed.journal
 
 ### Four kinds of documentation
 
+20191209: needs update. See also doc/README.
+
+
 <div style="margin:1em 2em; font-style:italic;">
 "There is a secret that needs to be understood in order to write good
 software documentation: there isn’t one thing called documentation,
diff --git a/doc/README b/doc/README
index 9bdcbb87f..feb3cad51 100644
--- a/doc/README
+++ b/doc/README
@@ -1,7 +1,9 @@
 HLEDGER_SRC/doc - starting point for hledger documentation files.
 
 
-20190901: needs update
+20190901: needs update.
+site/ is now a symlink to the separate hledger_site repo.
+See also Shake.hs.
 
 
 hledger doc files can be divided into several groups: