edits...

diff --git a/doc/build/content/tutorial.txt b/doc/build/content/tutorial.txt
index 0d873a6e6e1f23028ec08258093d27613f3d3faa..ef36f696bfdbdeaa67a46e77382d3bdde1b9e003 100644 (file)
--- a/doc/build/content/tutorial.txt
+++ b/doc/build/content/tutorial.txt
@@ -1,6 +1,6 @@
 Tutorial\r
 ========\r
-This tutorial is a "quick start" guide to SQLAlchemy.  You may wish to skip it and dive into the [main manual][manual] which is more reference-oriented.\r
+This tutorial provides a relatively simple walking tour through the basic concepts of SQLAlchemy.  You may wish to skip it and dive into the [main manual][manual] which is more reference-oriented.\r
 \r
 [manual]: rel:howtoread\r
 \r
@@ -19,9 +19,9 @@ This command will download the latest version of SQLAlchemy from the [Python Che
 [install setuptools]: http://peak.telecommunity.com/DevCenter/EasyInstall#installation-instructions\r
 [cheese]: http://cheeseshop.python.org/pypi\r
 \r
-### Installing A Database Manager {@name=dbms}\r
+### Installing a Database API {@name=dbms}\r
 \r
- SQLAlchemy is designed to operate with a [DBAPI][DBAPI] implementation built for a particular database, and includes support for the most popular databases. If you have one of the [supported database managers][supported dbms], you can proceed to the following section. Otherwise [SQLite][] is an easy to use database to get started with, requiring very little configuration.\r
+SQLAlchemy is designed to operate with a [DBAPI][DBAPI] implementation built for a particular database, and includes support for the most popular databases. If you have one of the [supported DBAPI implementations][supported dbms], you can proceed to the following section. Otherwise [SQLite][] is an easy-to-use database to get started with, which works with plain files or in-memory databases.\r
 \r
 [DBAPI]: http://www.python.org/doc/peps/pep-0249/\r
 \r
@@ -42,12 +42,12 @@ Getting Started {@name=gettingstarted}
 \r
 ### Connecting to the Database\r
 \r
-First, you need to connect to the database you want to work with:\r
+The first thing needed is a handle to the desired database, represented by a `SQLEngine` object.  This object handles the business of managing connections and dealing with the specifics of a particular database.  Below, we will make a SQLite connection to a file-based database called "tutorial.db".\r
 \r
     >>> from sqlalchemy import *\r
     >>> db = create_engine('sqlite://filename=tutorial.db')\r
 \r
-Documentation on creating engines is available in [dbengine](rel:dbengine).\r
+For full information on creating database engines, including those for SQLite and others, see [dbengine](rel:dbengine).\r
 \r
 ### Creating a Table {@name=table}\r
 \r