Changeset 6006

Timestamp:

08/25/07 13:43:32 (1 year ago)

Author:

adrian

Message:

Fixed #5195 -- Added notes to docs/tutorial01.txt about max_length and unicode() changes and 0.96 vs. development version. Thanks, ubernostrum

Files:

• django/trunk/docs/tutorial01.txt (modified) (2 diffs)

django/trunk/docs/tutorial01.txt

@@ -259 +259 @@
-        choice = models.CharField(max_length=200)
-        votes = models.IntegerField()
+
+.. adminition:: Errors about ``max_length``
+
+   If Django gives you an error message saying that ``max_length`` is
+   not a valid argument, you're most likely using an old version of
+   Django. (This version of the tutorial is written for the latest
+   development version of Django.) If you're using a Subversion checkout
+   of Django's development version (see `the installation docs`_ for
+   more information), you shouldn't have any problems.
+
+   If you want to stick with an older version of Django, you'll want to
+   switch to `the Django 0.96 tutorial`_, because this tutorial covers
+   several features that only exist in the Django development version.
+
+.. _the installation docs: ../install/
+.. _the Django 0.96 tutorial: ../0.96/tutorial01/
-
-The code is straightforward. Each model is represented by a class that
@@ -488 +504 @@
-            return self.choice
-
+.. admonition:: If ``__unicode__()`` doesn't seem to work
+
+   If you add the ``__unicode__()`` method to your models and don't
+   see any change in how they're represented, you're most likely using
+   an old version of Django. (This version of the tutorial is written
+   for the latest development version of Django.) If you're using a
+   Subversion checkout of of Django's development version (see `the
+   installation docs`_ for more information), you shouldn't have any
+   problems.
+
+   If you want to stick with an older version of Django, you'll want to
+   switch to `the Django 0.96 tutorial`_, because this tutorial covers
+   several features that only exist in the Django development version.
+
+.. _the installation docs: ../install/
+.. _the Django 0.96 tutorial: ../0.96/tutorial01/
+
-It's important to add ``__unicode__()`` methods to your models, not only for
-your own sanity when dealing with the interactive prompt, but also because