Typoes and spellings

Author: shabda

source/contents.txt

@@ -12,7 +12,7 @@ Getting the docs
 ----------------------
 The documents are generated using `Sphinx <http://sphinx.pocoo.org/>`_. The code
 is available on `Github <http://github.com/uswaretech/django-design-patterns/tree/master>`_.
-The generated Html is available on http://djangodesignpatterns.uswaretech.net/
+The generated Html is available on http://uswaretech.com/books/djangodesignpatterns/
 
 License
 -------------

source/misc.txt

@@ -10,7 +10,7 @@ out of settings.py into localsettings.py. In your settings.py, you should do::
     try:
         from localsettings import *
     except ImportError:
-        print 'localsetting could not be imported'
+        print 'localsettings could not be imported'
         pass #Or raise
 
 This should be at the end of settings.py, so that localsetting.py override
@@ -41,7 +41,7 @@ the request to output this. Make it as a templatetag.
 Import as if your apps are on your project path
 ----------------------------------------------------
 Instead of doing `from project.app.models import ModelClass` do `from app.models
-import ModelClass`. Your apps are reusable
+import ModelClass`. This makes you apps reusable  as they are not tied to a project.
 
 Naming things
 -----------------
@@ -56,12 +56,12 @@ and not::
     class Posts(models.Model):
         ...
 
-Foreign key should use the name of referenced class.::
+Foreign key should use the name of the referenced class.::
 
     class Post(models.Model):
             user = models.ForeignKey(User)
 
-Queryset should be plural, instances should be singular.::
+Querysets should be plural, instances should be singular.::
 
     posts = Post.objects.all()
     posts = Post.objects.filter(...)
@@ -207,8 +207,8 @@ Have you handled all cases?
             ...
 
 Or it is? What about users created via `manage.py createsuperuser`, with the
-above middleware, the default user can not even access the admi site.
+above middleware, the default user can not even access the admin site.
 
 Hence handle all scenarios in middleware and context processors. This is one place
-where `try: .. except: ..` (bare except) block are acceptable. You do not wnat one
-middleare  bringing down entire site.
+where `try: .. except: ..` (bare except) blocks are acceptable. You do not want one
+middleare  bringing down the entire site.

source/models.txt

@@ -19,6 +19,9 @@ False in your Model).::
         all_objects = models.Manager()
         objects = ModelClassApprovedOnlyManager()
 
+If you use multiple managers, the first manager should be the default manager. This is as the first
+manager is accesible as `ModelClass._default_manager`, which is used by admin to get all objects.
+        
 Hierarchical Relationships
 ----------------------------
 You may want to model hierarchical relationships. The simplest way to do this is::
@@ -27,9 +30,9 @@ You may want to model hierarchical relationships. The simplest way to do this is
         ...
         parent = models.ForeignKey('ModelClass')
 
-This is called adjacency list model, is very inefficient for large trees. If you
+This is called adjacency list model, and is very inefficient for large trees. If your
 trees are very shallow you can use this. Otherwise you want to use a more
-complex modeling called MPTT. Fortunately, you can just use django-mptt.
+efficient but complex modeling called MPTT. Fortunately, you can just use django-mptt.
 
 Singleton classes
 -------------------

source/templates.txt

@@ -4,8 +4,8 @@ templates
 
 Projects and apps.
 --------------------
-There should be one base.html at the project level, and one base.html at each of
-the app levels. The app level base.html should extend the project level
+There should be one base.html at the project level, and one `base.html` at each of
+the app levels. The app level `base.html` should extend the project level
 `base.html`.::
 
     {# Eg Project base.html #}

source/urls.txt

@@ -5,8 +5,8 @@ Urls
 Projects and apps
 --------------------
 
-There should be one urls.py at the project level, and one urls.py at each app
-level. The project level urls.py should include each of the urls.py under a
+There should be one `urls.py` at the project level, and one `urls.py` at each app
+level. The project level `urls.py` should include each of the `urls.py` under a
 prefix.::
 
     #project urls.py

source/views.txt

@@ -29,11 +29,22 @@ be posted on these objects, which this generic view does not allow.::
 Handle GET and POST in same view function
 ----------------------------------------------
 
+This keeps things grouped logically together. Eg.::
+
+    def foo(request):
+        form = FormClass()
+        if request.method == 'POST':
+            #Handle post and form saving etv.
+            #Redirect etc
+        #Any more get handling
+        payload = {'form': form, ...}
+        return render_to_response(...)
+
 
 Querysets are chainable and lazy
 -----------------------------------
 This means that your view can keep on creating querysets and they would be
-evaluated onlly when used. Supposed when you have an advanced search view which
+evaluated only when used. Suppose you have an advanced search view which
 can take multiple criteria all of which are optional.::
 
     def advanced_search(request, criteria1=None, criteria2=None, criteria3=None):

source/workflow.txt

@@ -4,12 +4,12 @@ workflow
 
 Use a source control system
 -------------------------------
-Use SVN, GIT, Hg whavere. But choose one and use it.
+Use SVN, GIT, Hg whatever. But choose one and use it.
 
 Use a bug tracking tool.
 ----------------------------
-I recommend `Unfuddle <http://unfuddle.com/>`_, (It has various other niecties).
-But others might work for you.
+I recommend `Unfuddle <http://unfuddle.com/>`_, (It has various niceties, above a source control and bug tracking tool).
+But others might work for you. In particular Trac is free.
 
 Use a schema migration tool
 ------------------------------
@@ -18,7 +18,7 @@ south is propbably more popular.
 
 Create various entries in your /etc/hosts mapped to localhost
 ------------------------------------------------------------------
-While development you probably want various users logged in to the site
+While development you probably want multiple users logged in to the site
 simulataneously. For example, while developing, I have one user logged in the admin, one normal
 user using the site. If both try to access the site from localhost, one will be
 logged out when other logs in.