diff --git a/docs/tutorial01.txt b/docs/tutorial01.txt index 179f248806..45bc3dcf91 100644 --- a/docs/tutorial01.txt +++ b/docs/tutorial01.txt @@ -128,7 +128,9 @@ This directory structure will house the poll application. The first step in writing a database Web app in Django is to define your models -- essentially, your database layout, with additional metadata. - PHILOSOPHY: A model is the single, definitive source of data about your +.. admonition:: Philosophy + + A model is the single, definitive source of data about your data. It contains the essential fields and behaviors of the data you're storing. Django follows the `DRY Principle`_. The goal is to define your data model in one place and automatically derive things from it. @@ -195,7 +197,9 @@ is able to: But first we need to tell our project that the ``polls`` app is installed. - PHILOSOPHY: Django apps are "pluggable": You can use an app in multiple +.. adminition:: Philosophy + + Django apps are "pluggable": You can use an app in multiple projects, and you can distribute apps, because they're not tied to a given Django installation. diff --git a/docs/tutorial02.txt b/docs/tutorial02.txt index 8a760b1a1d..98d7bf9f61 100644 --- a/docs/tutorial02.txt +++ b/docs/tutorial02.txt @@ -9,21 +9,20 @@ application and will focus on Django's automatically-generated admin site. .. _Tutorial 1: http://www.djangoproject.com/documentation/tutorial1/ -Philosophy -========== - -Generating admin sites for your staff or clients to add, change and delete -content is tedious work that doesn't require much creativity. For that reason, -Django entirely automates creation of admin interfaces for models. - -Django was written in a newsroom environment, with a very clear separation -between "content publishers" and the "public" site. Site managers use the -system to add news stories, events, sports scores, etc., and that content is -displayed on the public site. Django solves the problem of creating a unified -interface for site administrators to edit content. - -The admin isn't necessarily intended to be used by site visitors; it's for site -managers. +.. admonition:: Philosophy + + Generating admin sites for your staff or clients to add, change and delete + content is tedious work that doesn't require much creativity. For that reason, + Django entirely automates creation of admin interfaces for models. + + Django was written in a newsroom environment, with a very clear separation + between "content publishers" and the "public" site. Site managers use the + system to add news stories, events, sports scores, etc., and that content is + displayed on the public site. Django solves the problem of creating a unified + interface for site administrators to edit content. + + The admin isn't necessarily intended to be used by site visitors; it's for site + managers. Start the development server ============================