magic-removal: Started reworking docs/tutorial01.txt

git-svn-id: http://code.djangoproject.com/svn/django/branches/magic-removal@2637 bcc190cf-cafb-0310-a4f2-bffc1f526a37

1 files changed, 17 insertions, 18 deletions

diff --git a/docs/tutorial01.txt b/docs/tutorial01.txt
index e74a43da7e..22b099714f 100644
--- a/docs/tutorial01.txt
+++ b/docs/tutorial01.txt
@@ -6,13 +6,13 @@ By Adrian Holovaty <holovaty@gmail.com>
 
 Let's learn by example.
 
-Throughout this tutorial, we'll walk you through the creation of a simple Web
-poll application.
+Throughout this tutorial, we'll walk you through the creation of a basic
+blogging application.
 
 It'll consist of two parts:
 
-* A public site that lets people vote in polls and view poll results.
-* An admin site that lets you add, change and delete polls behind the scenes.
+* A public site that lets people read your blog entries and submit comments.
+* An admin site that lets you add, change and delete entries and comments.
 
 We'll assume you have `Django installed`_ already.
 
@@ -65,9 +65,9 @@ These files are:
 The development server
 ----------------------
 
-Change into the ``myproject`` directory, if you haven't already, and run the
-command ``python manage.py runserver``. You'll see the following output on the
-command line::
+Let's verify this worked. Change into the ``myproject`` directory, if you
+haven't already, and run the command ``python manage.py runserver``. You'll see
+the following output on the command line::
 
     Validating models...
     0 errors found.
@@ -76,31 +76,30 @@ command line::
     Development server is running at http://127.0.0.1:8000/
     Quit the server with CONTROL-C (Unix) or CTRL-BREAK (Windows).
 
-(If you get an error about ``DATABASE_ENGINE``, edit your ``settings.py`` file
-to change the ``DATABASE_ENGINE`` setting to point to the correct database, and
-make sure you have the right database libraries installed -- such as PostgreSQL's
-psycopg or MySQL's MySQLdb.)
-
 You've started the Django development server, a lightweight, pure-Python Web
-server that builds on the BaseHTTPServer included in Python's standard library.
-We've included this with Django so you can develop things rapidly, without
-having to deal with configuring Apache until you're ready for production.
+server. We've included this with Django so you can develop things rapidly,
+without having to deal with configuring Apache until you're ready for
+production.
 
-DON'T use this server in anything resembling a production environment. It's
-intended only for use while developing.
+Now's a good time to note: DON'T use this server in anything resembling a
+production environment. It's intended only for use while developing.
 
 .. admonition:: Changing the port
 
     By default, the ``runserver`` command starts the development server on port
     8000. If you want to change the server's port, pass it as a command-line
-    argument::
+    argument. For instance, this command starts the server on port 8080::
 
         python manage.py runserver 8080
 
+    Full docs for the development server are at `django-admin documentation`_.
+
 Now that the server's running, visit http://127.0.0.1:8000/ with your Web
 browser. You'll see a "Welcome to Django" page, in pleasant, light-blue pastel.
 It worked!
 
+.. django-admin documentation: http://www.djangoproject.com/documentation/django_admin/
+
 Database setup
 --------------