diff --git a/docs/whirled/design.txt b/docs/whirled/design.txt
index a5f02bfa2..d40672d31 100644
--- a/docs/whirled/design.txt
+++ b/docs/whirled/design.txt
@@ -30,3 +30,17 @@ scene database, from which they can then continue to mirror updates as
 needed.
 
 * Notes
+Scenes map to places.
+
+Scene manager extends place manager, handles scene related stuff.
+
+Scene manager registers a timer when it becomes empty and flushes itself
+from memory after timeout period.
+
+Location manager is used to navigate between scenes on the client;
+location services will need extensions to support delivering scene version
+with moveTo request and serialized scene data with moveTo response
+(desirable to avoid extra server round-trips).
+
+Client should avoid unsubscribing from scene objects straight away so that
+it can avoid resubscribing if they bounce back and forth between scenes.