diff --git a/src/applications/maniphest/config/PhabricatorManiphestConfigOptions.php b/src/applications/maniphest/config/PhabricatorManiphestConfigOptions.php
index b12b7222bf..70249ce079 100644
--- a/src/applications/maniphest/config/PhabricatorManiphestConfigOptions.php
+++ b/src/applications/maniphest/config/PhabricatorManiphestConfigOptions.php
@@ -179,6 +179,11 @@ The keys you can provide in a specification are:
     to this status by writing `Closes T123 as invalid`, even if another status
     is selected by the "Closes" prefix.
 
+Statuses will appear in the UI in the order specified. Note the status marked
+`special` as `duplicate` is not settable directly and will not appear in UI
+elements, and that any status marked `silly` does not appear if Phabricator
+is configured with `phabricator.serious-business` set to true.
+
 Examining the default configuration and examples below will probably be helpful
 in understanding these options.