moved cookbook entries into categories and gave a very brief intro to each section

[catagits/Catalyst-Runtime.git] / lib / Catalyst / Manual / Tutorial.pod

diff --git a/lib/Catalyst/Manual/Tutorial.pod b/lib/Catalyst/Manual/Tutorial.pod
index d69d300..5a32fc8 100644 (file)
--- a/lib/Catalyst/Manual/Tutorial.pod
+++ b/lib/Catalyst/Manual/Tutorial.pod
@@ -2,60 +2,53 @@
 
 Catalyst::Manual::Tutorial - Catalyst Tutorial: Overview
 
-
-
 =head1 DESCRIPTION
 
-The Catalyst framework is a flexible and comprehensive environment for quickly building high-functionality web applications.  This tutorial is design to provide a rapid introduction to its basics and most commonly used features while focusing on real-world best practices.
+The Catalyst framework is a flexible and comprehensive environment for
+quickly building high-functionality web applications.  This tutorial is
+designed to provide a rapid introduction to its basics and its most
+commonly used features while focusing on real-world best practices.
 
-The tutorial is broken down into the following sections:
+The tutorial is divided into the following sections:
 
 =over 4
 
 =item *
 
-L<Introduction|Catalyst::Manual::Tutorial01_Intro>
+L<Introduction|Catalyst::Manual::Tutorial::Intro>
 
 =item * 
 
-L<Catalyst Basics|Catalyst::Manual::Tutorial02_CatalystBasics>
+L<Catalyst Basics|Catalyst::Manual::Tutorial::CatalystBasics>
 
 =item * 
 
-L<CRUD|Catalyst::Manual::Tutorial03_BasicCRUD>
+L<Basic CRUD|Catalyst::Manual::Tutorial::BasicCRUD>
 
 =item * 
 
-L<Authentication|Catalyst::Manual::Tutorial04_Authentication>
+L<Authentication|Catalyst::Manual::Tutorial::Authentication>
 
 =item * 
 
-L<Authorization|Catalyst::Manual::Tutorial05_Authorization>
+L<Authorization|Catalyst::Manual::Tutorial::Authorization>
 
 =item * 
 
-L<Debugging|Catalyst::Manual::Tutorial06_Debugging>
+L<Testing|Catalyst::Manual::Tutorial::Testing>
 
 =item * 
 
-L<Testing|Catalyst::Manual::Tutorial07_Testing>
+L<Advanced CRUD|Catalyst::Manual::Tutorial::AdvancedCRUD>
 
 =item * 
 
-L<CRUD|Catalyst::Manual::Tutorial08_AdvancedCRUD>
-
-=item * 
-
-L<Appendicies|Catalyst::Manual::Tutorial09_Appendicies>
+L<Appendices|Catalyst::Manual::Tutorial::Appendices>
 
 =back
 
-
-Full source code is available for each section via the main Catalyst Subversion repository at L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/>.  See the end of each section for the specifics on retrieving code for that section.
-
-A tarball of the final application is available at C<to_be_compled_in_final_version>.
-
-
+A tarball of the final application is available at
+C<to_be_compled_in_final_version>.
 
 =head1 Detailed Table Of Contents
 
@@ -82,7 +75,6 @@ WHERE TO GET WORKING CODE
 =back
 
 
-
 =head2 Part 2: Catalyst Application Development Basics
 
 =over 4
@@ -103,8 +95,6 @@ EDIT THE LIST OF CATALYST PLUGINS
 
 DATABASE ACCESS WITH DBIx::Class
 
-=over 4
-
 =item *
 
 Create a DBIC Schema File
@@ -115,11 +105,9 @@ Create the DBIC ``Result Source'' Files
 
 =item *
 
-Use Catalyst::Model::DBIC::Schema To Load The Model Class
-
-=back
+Use Catalyst::Model::DBIC::Schema to Load the Model Class
 
-=item *
+    =item *
 
 CREATE A CATALYST CONTROLLER
 
@@ -131,7 +119,7 @@ CATALYST VIEWS
 
 =item *
 
-Create a Catalyst View Using TTSITE
+Create a Catalyst View Using TTSite
 
 =item *
 
@@ -149,8 +137,6 @@ RUN THE APPLICATION
 
 =back
 
-
-
 =head2 Part 3: Basic CRUD
 
 =over 4
@@ -183,7 +169,7 @@ MANUALLY BUILDING A CREATE FORM
 
 =item *
 
-Add Method to Display The Form
+Add a Method to Display the Form
 
 =item *
 
@@ -195,7 +181,7 @@ Add Method to Process Form Values and Update Database
 
 =item *
 
-Test Out The Form
+Test Out the Form
 
 =back
 
@@ -221,8 +207,6 @@ Try the Delete Feature
 
 =back
 
-
-
 =head2 Part 4: Authentication
 
 =over 4
@@ -239,7 +223,7 @@ Add Users and Roles to the Database
 
 =item *
 
-Add User and Role Information to Dbic Schema
+Add User and Role Information to DBIC Schema
 
 =item *
 
@@ -305,8 +289,6 @@ Try Out the Hashed Passwords
 
 =back
 
-
-
 =head2 Part 5: Authorization
 
 =over 4
@@ -319,7 +301,7 @@ BASIC AUTHORIZATION
 
 =item *
 
-Update Plugins to Include Support Authorization
+Update Plugins to Include Support for Authorization
 
 =item *
 
@@ -361,7 +343,6 @@ Add a Method to Handle Access Violations
 
 =back
 
-
 =head2 Part 6: Debugging
 
 =over 4
@@ -376,8 +357,6 @@ RUNNING CATALYST UNDER THE PERL DEBUGGER
 
 =back
 
-
-
 =head2 Part 7: Testing
 
 =over 4
@@ -400,8 +379,6 @@ SUPPORTING BOTH PRODUCTION AND TEST DATABASES
 
 =back
 
-
-
 =head2 Part 8: Advanced CRUD
 
 =over 4
@@ -480,8 +457,6 @@ Use populate_from_widget in hw_create_do
 
 =back
 
-
-
 =head2 Part 9: Appendices
 
 =over 4