Fix typos
[catagits/Catalyst-Manual.git] / lib / Catalyst / Manual / Tutorial.pod
index ec4e4db..062a865 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<https://metacpan.org/module/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.
@@ -687,7 +694,7 @@ tutorial).
 
 =item *
 
-Kieren Diment for his oversite of Catalyst-related documentation.
+Kieren Diment for his oversight of Catalyst-related documentation.
 
 =item *
 
@@ -701,14 +708,17 @@ PostgreSQL content in the Appendix.
 =item *
 
 People who have emailed me with corrections and suggestions on the 
-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 and Adam Witney.  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).
+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, Adam 
+Witney and xenoterracide (Caleb Cushing). 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 and Rafael Kitover for the work on updating the 
+tutorial to include foreign key support for SQLite. I'm sure I am 
+missing some names here... apologies for that (please let me know if you 
+name should be here). 
 
 =back
 
@@ -716,9 +726,14 @@ you name should be here).
 
 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/>.
+Feel free to contact the author for any errors or suggestions, but the
+best way to report issues is via the CPAN RT Bug system at
+<https://rt.cpan.org/Public/Dist/Display.html?Name=Catalyst-Manual>.
+
+***TODO: Update
+The most recent version of the Catalyst Tutorial can be found at
+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/>).
+Copyright 2006-2010, Kennedy Clark, under the
+Creative Commons Attribution Share-Alike License Version 3.0
+(L<http://creativecommons.org/licenses/by-sa/3.0/us/>).