link fixes
[catagits/Catalyst-Manual.git] / lib / Catalyst / Manual / Tutorial.pod
index ec4e4db..772b4c8 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<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,56 +25,56 @@ 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
 
-Final code tarballs for each chapter of the tutorial are available at 
-L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial/>.
+Final code tarballs for each chapter of the tutorial are available at
+L<http://dev.catalystframework.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 
+Note: Click on the heading in the previous line to jump to the actual
 chapter. Below is a "table of contents" for this chapter.
 
 =over 4
@@ -91,9 +98,9 @@ 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 
+Note: Click on the heading in the previous line to jump to the actual
 chapter. Below is a "table of contents" for this chapter.
 
 =over 4
@@ -125,9 +132,9 @@ 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 
+Note: Click on the heading in the previous line to jump to the actual
 chapter. Below is a "table of contents" for this chapter.
 
 =over 4
@@ -264,9 +271,9 @@ 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 
+Note: Click on the heading in the previous line to jump to the actual
 chapter. Below is a "table of contents" for this chapter.
 
 =over 4
@@ -402,9 +409,9 @@ 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 
+Note: Click on the heading in the previous line to jump to the actual
 chapter. Below is a "table of contents" for this chapter.
 
 =over 4
@@ -500,9 +507,9 @@ 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 
+Note: Click on the heading in the previous line to jump to the actual
 chapter. Below is a "table of contents" for this chapter.
 
 =over 4
@@ -542,9 +549,9 @@ 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 
+Note: Click on the heading in the previous line to jump to the actual
 chapter. Below is a "table of contents" for this chapter.
 
 =over 4
@@ -568,9 +575,9 @@ 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 
+Note: Click on the heading in the previous line to jump to the actual
 chapter. Below is a "table of contents" for this chapter.
 
 =over 4
@@ -594,9 +601,9 @@ 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 
+Note: Click on the heading in the previous line to jump to the actual
 chapter. Below is a "table of contents" for this chapter.
 
 =over 4
@@ -608,9 +615,9 @@ 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 
+Note: Click on the heading in the previous line to jump to the actual
 chapter. Below is a "table of contents" for this chapter.
 
 =over 4
@@ -656,8 +663,8 @@ APPENDIX 3: IMPROVED HASHING SCRIPT
 
 =head1 THANKS
 
-This tutorial would not have been possible without the input of many 
-different people in the Catalyst community.  In particular, the 
+This tutorial would not have been possible without the input of many
+different people in the Catalyst community.  In particular, the
 primary author would like to thank:
 
 =over 4
@@ -683,11 +690,11 @@ key Catalyst modules.
 
 Other Catalyst documentation folks like Kieren Diment, Gavin Henry,
 and Jess Robinson (including their work on the original Catalyst
-tutorial).  
+tutorial).
 
 =item *
 
-Kieren Diment for his oversite of Catalyst-related documentation.
+Kieren Diment for his oversight of Catalyst-related documentation.
 
 =item *
 
@@ -700,15 +707,18 @@ 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).
+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, 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,10 @@ 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
+L<https://rt.cpan.org/Public/Dist/Display.html?Name=Catalyst-Manual>.
 
-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<https://creativecommons.org/licenses/by-sa/3.0/us/>).