[Catalyst-commits] r6292 - trunk/Catalyst-Manual/lib/Catalyst/Manual/Tutorial

[zarquon at dev.catalyst.perl.org]

Author: zarquon
Date: 2007-04-18 07:34:02 +0100 (Wed, 18 Apr 2007)
New Revision: 6292

Modified:
   trunk/Catalyst-Manual/lib/Catalyst/Manual/Tutorial/CatalystBasics.pod
Log:
added gentle warning about TTSite

Modified: trunk/Catalyst-Manual/lib/Catalyst/Manual/Tutorial/CatalystBasics.pod
===================================================================
--- trunk/Catalyst-Manual/lib/Catalyst/Manual/Tutorial/CatalystBasics.pod	2007-04-17 17:45:29 UTC (rev 6291)
+++ trunk/Catalyst-Manual/lib/Catalyst/Manual/Tutorial/CatalystBasics.pod	2007-04-18 06:34:02 UTC (rev 6292)
@@ -763,6 +763,16 @@
 files for common header and footer information, configuration values, a
 CSS stylesheet, and more.
 
+While TTSite is useful to bootstrap a project, we recommend that
+unless you know what your're doing or want to pretty much use the
+supplied templates as is, that you use the plain Template Toolkit view
+when starting a project from scratch.  This is because TTSite can be
+tricky to customize.  Additionally TT contains constructs that you
+need to learn yourself if you're going to be a serious user of TT.
+Our experience suggests that you're better off learning these from
+scratch.  We use it here precisely because it is useful for
+bootstrap/prototype purposes.
+
 Enter the following command to enable the C<TTSite> style of view
 rendering for this tutorial: