diff --git a/docs.xml b/docs.xml
index a975fd6e0..c3b7e987c 100644
--- a/docs.xml
+++ b/docs.xml
@@ -26,11 +26,18 @@
 
         XXX for no apparent reason, your CWD must be the main Ant source dir, or this will fail:
         .../docs.xml:64: org.apache.velocity.exception.ResourceNotFoundException: Unable to find resource './site.vsl'
-        
+
         After this generation the pages in docs/ should be up-to-date and need to be committed.
-        Since I don't remember whether there is a cron job updating the site I
-        usually log in to people.apache.org and run 'svn up' in /www/ant.apache.org/
-        (make sure your umask is 002 before you do that so the pages remain group writable).
+        
+        http://www.apache.org/dev/project-site.html#intro describes the routine of
+        updating the online homepage:
+        * log in to people.apache.org and run 'svn up' in /www/ant.apache.org/
+          (make sure your umask is 002 before you do that so the pages remain group writable).
+          
+        people.apache.org is not the live site, it is rsynced to the public site regularly
+        (once an hour ?). You can view your changes before they go into production by using
+        a trick with your web browser. Temporarily set the preferences to use 140.211.11.10:80
+        as your HTTP proxy.
     </description>
 
     <!-- Initialization properties -->