Incorporate Tom comments. Change v1.9 to latest throughout

bakerydemo/base/models.py

@@ -28,11 +28,11 @@ class People(ClusterableModel):
     """
     A Django model to store People objects.
     It uses the `@register_snippet` decorator to allow it to be accessible
-    as via the Snippets UI (e.g. /admin/snippets/base/people/)
+    via the Snippets UI (e.g. /admin/snippets/base/people/)
 
     `People` uses the `ClusterableModel`, which allows the relationship to another
     model (e.g. a PageModel) to be stored independently of the database. This
-    allows us to preview foreignKey relationships without first saving the parent
+    allows us to preview ForeignKey relationships without first saving the parent
     https://github.com/wagtail/django-modelcluster
     """
     first_name = models.CharField("First name", max_length=254)
@@ -100,7 +100,7 @@ class FooterText(models.Model):
 class StandardPage(Page):
     """
     A generic content page. On this demo site we use it for an about page but
-    could be used for any type of page content.
+    it could be used for any type of page content.
     """
 
     introduction = models.TextField(
@@ -284,8 +284,8 @@ class GalleryPage(Page):
     """
     This is a page to list locations from the selected Collection. We use a Q
     object to list any Collection created (/admin/collections/) even if they
-    contain no items. It's unlikely to be useful for many production settings
-    but is intended to show the extensibility of aspect of Wagtail
+    contain no items. In this demo we use it for a GalleryPage,
+    and is intended to show the extensibility of this aspect of Wagtail
     """
 
     introduction = models.TextField(
@@ -297,7 +297,8 @@ class GalleryPage(Page):
         blank=True,
         on_delete=models.SET_NULL,
         related_name='+',
-        help_text='Landscape mode only; horizontal width between 1000px and 3000px.'
+        help_text='Landscape mode only; horizontal width between 1000px and '
+        '3000px.'
     )
     body = StreamField(
         BaseStreamBlock(), verbose_name="Page body", blank=True
@@ -327,10 +328,10 @@ class FormField(AbstractFormField):
     """
     Wagtailforms is a module to introduce simple forms on a Wagtail site. It
     isn't intended as a replacement to Django's form support but as a quick way
-    to generate general purpose data-collection form without having to write
+    to generate a general purpose data-collection form without having to write
     code. We use it on the site for a contact form. You can read more about
     Wagtail forms at:
-    http://docs.wagtail.io/en/v1.9/reference/contrib/forms/index.html
+    http://docs.wagtail.io/en/latest/reference/contrib/forms/index.html
     """
     page = ParentalKey('FormPage', related_name='form_fields')
 

bakerydemo/blog/models.py

@@ -41,9 +41,9 @@ class BlogPeopleRelationship(Orderable, models.Model):
 
 class BlogPageTag(TaggedItemBase):
     """
-    This model allows us to creates a many-to-many relationship between 
+    This model allows us to creates a many-to-many relationship between
     the BlogPage object and tags. There's a longer guide on using it at
-    http://docs.wagtail.io/en/v1.9/reference/pages/model_recipes.html#tagging
+    http://docs.wagtail.io/en/latest/reference/pages/model_recipes.html#tagging
     """
     content_object = ParentalKey('BlogPage', related_name='tagged_items')
 
@@ -54,7 +54,7 @@ class BlogPage(Page):
 
     We access the People object with an inline panel that references the
     ParentalKey's related_name in BlogPeopleRelationship. More docs:
-    http://docs.wagtail.io/en/v1.9/topics/pages.html#inline-models
+    http://docs.wagtail.io/en/latest/topics/pages.html#inline-models
     """
     introduction = models.TextField(
         help_text='Text to describe the page',
@@ -167,7 +167,7 @@ class BlogIndexPage(RoutablePageMixin, Page):
 
     # Overrides the context to list all child items, that are live, by the
     # date that they were published
-    # http://docs.wagtail.io/en/v1.9/getting_started/tutorial.html#overriding-context
+    # http://docs.wagtail.io/en/latest/getting_started/tutorial.html#overriding-context
     def get_context(self, request):
         context = super(BlogIndexPage, self).get_context(request)
         context['posts'] = BlogPage.objects.descendant_of(
@@ -178,7 +178,7 @@ class BlogIndexPage(RoutablePageMixin, Page):
     # This defines a Custom view that utilizes Tags. This view will return all
     # related BlogPages for a given Tag or redirect back to the BlogIndexPage.
     # More information on RoutablePages is at
-    # http://docs.wagtail.io/en/v1.9/reference/contrib/routablepage.html
+    # http://docs.wagtail.io/en/latest/reference/contrib/routablepage.html
     @route('^tags/$', name='tag_archive')
     @route('^tags/(\w+)/$', name='tag_archive')
     def tag_archive(self, request, tag=None):

bakerydemo/breads/models.py

@@ -44,7 +44,7 @@ class BreadIngredient(models.Model):
     to the `@register_snippet` decorator. We use a new piece of functionality
     available to Wagtail called the ParentalManyToManyField on the BreadPage
     model to display this. The Wagtail Docs give a slightly more detailed example
-    http://docs.wagtail.io/en/v1.9/getting_started/tutorial.html#categories
+    http://docs.wagtail.io/en/latest/getting_started/tutorial.html#categories
     """
     name = models.CharField(max_length=255)
 

bakerydemo/locations/models.py

@@ -110,7 +110,7 @@ class LocationsIndexPage(Page):
 
     # Overrides the context to list all child
     # items, that are live, by the date that they were published
-    # http://docs.wagtail.io/en/v1.9/getting_started/tutorial.html#overriding-context
+    # http://docs.wagtail.io/en/latest/getting_started/tutorial.html#overriding-context
     def get_context(self, request):
         context = super(LocationsIndexPage, self).get_context(request)
         context['locations'] = LocationPage.objects.descendant_of(