diff --git a/contrib/extended_room.py b/contrib/extended_room.py
index b0e45a680d..5335a5d583 100644
--- a/contrib/extended_room.py
+++ b/contrib/extended_room.py
@@ -290,6 +290,13 @@ class CmdExtendedDesc(default_cmds.CmdDesc):
 
     The alias @detail allows to assign a "detail" (a non-object
     target for the look command) to the current room.
+
+    You can also embed special time markers in your description, like this:
+      <night>In the darkness, the forest looks foreboding.</night>. Text
+    marked this way will only display when the server is truly at the given
+    time slot. The available times
+    are night, morning, afternoon and evening.
+
     """
     aliases = ["@describe", "@detail"]