Browse files

Added 'Session object guidlines' section to docs/sessions.txt

git-svn-id: http://code.djangoproject.com/svn/django/trunk@524 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent 21c4526 commit 99d8bb34fe034161c9f6ca7587a0f8b87a2f1236 @adrianholovaty adrianholovaty committed Aug 17, 2005
Showing with 12 additions and 0 deletions.
  1. +12 −0 docs/sessions.txt
View
12 docs/sessions.txt
@@ -63,6 +63,18 @@ It also has these two methods:
You can edit ``request.session`` at any point in your view. You can edit it
multiple times.
+Session object guidelines
+-------------------------
+
+ * Use normal Python strings as dictionary keys on ``request.session``. This
+ is more of a convention than a hard-and-fast rule.
+
+ * Session dictionary keys that begin with an underscore are reserved for
+ internal use by Django.
+
+ * Don't override ``request.session`` with a new object, and don't access or
+ set its attributes. Use it like a Python dictionary.
+
Examples
--------

0 comments on commit 99d8bb3

Please sign in to comment.