note that properties are runtime

buildbot · Aug 29, 2011 · 00e1d39 · 00e1d39
1 parent 9ae8752
commit 00e1d39
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/master/docs/manual/cfg-properties.rst b/master/docs/manual/cfg-properties.rst
@@ -39,6 +39,10 @@ override one supplied by a scheduler.
 Properties are stored internally in JSON format, so they are limited to basic
 types of data: numbers, strings, lists, and dictionaries.
 
+.. note:: Properties are defined while a build is in progress; their values are
+    not available when the configuration file is parsed.  This can sometimes
+    confuse newcomers to Buildbot!
+
 .. index:: single: Properties; Common Properties
 
 .. _Common-Build-Properties: