add some more docs to direct.py

1 files changed, 4 insertions, 0 deletions

diff --git a/nova/api/direct.py b/nova/api/direct.py
index 1011091a6..2e158e89e 100644
--- a/nova/api/direct.py
+++ b/nova/api/direct.py
@@ -225,6 +225,10 @@ class Limited(object):
     Additionally where appropriate methods can be added or overwritten, for
     example to provide backwards compatibility.
 
+    The wrapping approach has been chosen so that the wrapped API can maintain
+    its own internal consistency, for example if it calls "self.create" it
+    should get its own create method rather than anything we do here.
+
     """
 
     _allowed = None