instructions on how to read the tutorial
[catagits/Catalyst-Manual.git] / lib / Catalyst / Manual / Tutorial.pod
index b9a21c3..59bb3a3 100644 (file)
@@ -9,6 +9,13 @@ 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.
 
+We suggest that you read this introduction on the web.  Make sure you are
+reading the latest version of the tutorial by visiting
+L<http://search.cpan.org/perldoc?Catalyst::Manual::Tutorial>.  Alternatively
+you can use CPAN modules like L<Pod::Webserver>, L<Pod::POM::Web>,
+L<Pod::Browser> (Catalyst based), or L<CPAN::Mini::Webserver> to read a local
+copy of the tutorial.
+
 The tutorial is divided into the following sections:
 
 B<NOTE: CLICK THESE LINKS TO JUMP TO CHAPTERS> (the index links above
@@ -18,43 +25,43 @@ only navigate inside this page).
 
 =item 1
 
-L<Introduction|Catalyst::Manual::Tutorial::Intro>
+L<Introduction|Catalyst::Manual::Tutorial::01_Intro>
 
 =item 2
 
-L<Catalyst Basics|Catalyst::Manual::Tutorial::CatalystBasics>
+L<Catalyst Basics|Catalyst::Manual::Tutorial::02_CatalystBasics>
 
 =item 3
 
-L<More Catalyst Basics|Catalyst::Manual::Tutorial::MoreCatalystBasics>
+L<More Catalyst Basics|Catalyst::Manual::Tutorial::03_MoreCatalystBasics>
 
 =item 4
 
-L<Basic CRUD|Catalyst::Manual::Tutorial::BasicCRUD>
+L<Basic CRUD|Catalyst::Manual::Tutorial::04_BasicCRUD>
 
 =item 5
 
-L<Authentication|Catalyst::Manual::Tutorial::Authentication>
+L<Authentication|Catalyst::Manual::Tutorial::05_Authentication>
 
 =item 6
 
-L<Authorization|Catalyst::Manual::Tutorial::Authorization>
+L<Authorization|Catalyst::Manual::Tutorial::06_Authorization>
 
 =item 7
 
-L<Debugging|Catalyst::Manual::Tutorial::Debugging>
+L<Debugging|Catalyst::Manual::Tutorial::07_Debugging>
 
 =item 8
 
-L<Testing|Catalyst::Manual::Tutorial::Testing>
+L<Testing|Catalyst::Manual::Tutorial::08_Testing>
 
 =item 9
 
-L<Advanced CRUD|Catalyst::Manual::Tutorial::AdvancedCRUD>
+L<Advanced CRUD|Catalyst::Manual::Tutorial::09_AdvancedCRUD>
 
 =item 10
 
-L<Appendices|Catalyst::Manual::Tutorial::Appendices>
+L<Appendices|Catalyst::Manual::Tutorial::10_Appendices>
 
 =back
 
@@ -65,7 +72,7 @@ L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial/>.
 =head1 Detailed Table of Contents
 
 
-=head2 L<Chapter 1: Intro|Catalyst::Manual::Tutorial::Intro>
+=head2 L<Chapter 1: Intro|Catalyst::Manual::Tutorial::01_Intro>
 
 Note: Click on the heading in the previous line to jump to the actual 
 chapter. Below is a "table of contents" for this chapter.
@@ -91,7 +98,7 @@ WHERE TO GET WORKING CODE
 =back
 
 
-=head2 L<Chapter 2: Catalyst Basics|Catalyst::Manual::Tutorial::CatalystBasics>
+=head2 L<Chapter 2: Catalyst Basics|Catalyst::Manual::Tutorial::02_CatalystBasics>
 
 Note: Click on the heading in the previous line to jump to the actual 
 chapter. Below is a "table of contents" for this chapter.
@@ -125,7 +132,7 @@ CREATE A SIMPLE CONTROLLER AND AN ACTION
 =back
 
 
-=head2 L<Chapter 3: More Catalyst Basics|Catalyst::Manual::Tutorial::MoreCatalystBasics>
+=head2 L<Chapter 3: More Catalyst Basics|Catalyst::Manual::Tutorial::03_MoreCatalystBasics>
 
 Note: Click on the heading in the previous line to jump to the actual 
 chapter. Below is a "table of contents" for this chapter.
@@ -264,7 +271,7 @@ Return To A Manually-Specified Template
 =back
 
 
-=head2 L<Chapter 4: Basic CRUD|Catalyst::Manual::Tutorial::BasicCRUD>
+=head2 L<Chapter 4: Basic CRUD|Catalyst::Manual::Tutorial::04_BasicCRUD>
 
 Note: Click on the heading in the previous line to jump to the actual 
 chapter. Below is a "table of contents" for this chapter.
@@ -402,7 +409,7 @@ Adding Methods to Result Classes
 =back
 
 
-=head2 L<Chapter 5: Authentication|Catalyst::Manual::Tutorial::Authentication>
+=head2 L<Chapter 5: Authentication|Catalyst::Manual::Tutorial::05_Authentication>
 
 Note: Click on the heading in the previous line to jump to the actual 
 chapter. Below is a "table of contents" for this chapter.
@@ -500,7 +507,7 @@ Switch To Flash-To-Stash
 =back
 
 
-=head2 L<Chapter 6: Authorization|Catalyst::Manual::Tutorial::Authorization>
+=head2 L<Chapter 6: Authorization|Catalyst::Manual::Tutorial::06_Authorization>
 
 Note: Click on the heading in the previous line to jump to the actual 
 chapter. Below is a "table of contents" for this chapter.
@@ -542,7 +549,7 @@ ENABLE MODEL-BASED AUTHORIZATION
 =back
 
 
-=head2 L<Chapter 7: Debugging|Catalyst::Manual::Tutorial::Debugging>
+=head2 L<Chapter 7: Debugging|Catalyst::Manual::Tutorial::07_Debugging>
 
 Note: Click on the heading in the previous line to jump to the actual 
 chapter. Below is a "table of contents" for this chapter.
@@ -568,7 +575,7 @@ TT DEBUGGING
 =back
 
 
-=head2 L<Chapter 8: Testing|Catalyst::Manual::Tutorial::Testing>
+=head2 L<Chapter 8: Testing|Catalyst::Manual::Tutorial::08_Testing>
 
 Note: Click on the heading in the previous line to jump to the actual 
 chapter. Below is a "table of contents" for this chapter.
@@ -594,7 +601,7 @@ SUPPORTING BOTH PRODUCTION AND TEST DATABASES
 =back
 
 
-=head2 L<Chapter 9: Advanced CRUD|Catalyst::Manual::Tutorial::AdvancedCRUD>
+=head2 L<Chapter 9: Advanced CRUD|Catalyst::Manual::Tutorial::09_AdvancedCRUD>
 
 Note: Click on the heading in the previous line to jump to the actual 
 chapter. Below is a "table of contents" for this chapter.
@@ -608,7 +615,7 @@ ADVANCED CRUD OPTIONS
 =back
 
 
-=head2 L<Chapter 10: Appendices|Catalyst::Manual::Tutorial::Appendices>
+=head2 L<Chapter 10: Appendices|Catalyst::Manual::Tutorial::10_Appendices>
 
 Note: Click on the heading in the previous line to jump to the actual 
 chapter. Below is a "table of contents" for this chapter.
@@ -705,10 +712,11 @@ tutorial.  As of the most recent release, this include: Florian
 Ragwitz, Mauro Andreolini, Jim Howard, Giovanni Gigante, William 
 Moreno,  Bryan Roach, Ashley Berlin, David Kamholz, Kevin Old, Henning 
 Sprang, Jeremy Jones, David Kurtz, Ingo Wichmann, Shlomi Fish, Murray 
-Walker.  Also, thanks to Devin Austin for coming up with an initial 
-version of a non-TTSite wrapper page.  I'm sure I am missing some 
-names here... apologies for that (please let me know if you name 
-should be here).
+Walker and Adam Witney.  Thanks to Devin Austin for coming up with an 
+initial version of a non-TTSite wrapper page.  Also, a huge thank you 
+to Kiffin Gish for all the hard work on the "database depluralization" 
+effort!  I'm sure I am missing some names here... apologies for that 
+(please let me know if you name should be here).
 
 =back
 
@@ -718,7 +726,7 @@ Kennedy Clark, C<hkclark@gmail.com>
 
 Please report any errors, issues or suggestions to the author.  The
 most recent version of the Catalyst Tutorial can be found at
-L<http://dev.catalyst.perl.org/repos/Catalyst/Catalyst-Manual/5.70/trunk/lib/Catalyst/Manual/Tutorial/>.
+L<http://dev.catalyst.perl.org/repos/Catalyst/Catalyst-Manual/5.80/trunk/lib/Catalyst/Manual/Tutorial/>.
 
 Copyright 2006-2008, Kennedy Clark, under Creative Commons License
 (L<http://creativecommons.org/licenses/by-nc-sa/2.5/>).