X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Manual.git;a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FDeployment.pod;h=745bdcf18a8bb3765845119c6d6736ecc85a37e7;hp=665eff8e01dab65636591f5c1cd5d63b31648741;hb=2d62c370d643f3abbe765aaba07ed2e188f31de7;hpb=0e8eed8eaeef86103384ed21f603749515c784c8

diff --git a/lib/Catalyst/Manual/Deployment.pod b/lib/Catalyst/Manual/Deployment.pod
index 665eff8..745bdcf 100644
--- a/lib/Catalyst/Manual/Deployment.pod
+++ b/lib/Catalyst/Manual/Deployment.pod
@@ -4,17 +4,27 @@ Catalyst::Manual::Deployment - Deploying Catalyst
 
 =head1 DEPLOYMENT OPTIONS
 
-=head2 Deployment for shared hosting
+Catalyst applications most often deployed as a FastCGI or mod_perl application, however
+as Catalyst is based on the L<PSGI> specification, any web handler implementing that specification
+can be used to run Catalyst applications.
 
-L<Catalyst::Manual::Deployment::SharedHosting>
+This documentation most thoroughly covers the normal and traditional deployment options, but
+will mention alternate methods of deployment, and we welcome additional documentation from
+people deploying Catalyst in non-standard environments.
 
-=head2 mod_perl
+=head2 Deployment for shared hosting
+
+Almost all shared hosting environments involve deploying Catalyst as a FastCGI on Apache.
 
-L<Catalyst::Manual::Deployment::Apache::mod_perl>
+You will usually want to have a set of libraries specific to your application installed on
+your shared host, and there are instructions about
+this in L<Catalyst::Manual::Deployment::SharedHosting>.
 
 =head2 FastCGI
 
-L<Catalyst::Manual::Deployment::FastCGI>
+FastCGI is the most common Catalyst deployment option, it is documented generally in
+L<Catalyst::Manual::Deployment::FastCGI>, and there are specific instructions for common
+web servers linked below:
 
 =head3 Apache
 
@@ -32,12 +42,38 @@ L<Catalyst::Manual::Deployment::lighttpd::FastCGI>
 
 L<Catalyst::Manual::Deployment::IIS::FastCGI>
 
+=head2 mod_perl
+
+Traditionally a common deployment option for dedicated applications, with some advantages and
+disadvantages over FastCGI. This is documented in L<Catalyst::Manual::Deployment::Apache::mod_perl>.
+
 =head2 Development Server
 
-L<Catalyst::Manual::Deployment::DevelopmentServer>.
+It is possible to deploy the Catalyst development server behind a reverse proxy. This may work
+well for small scale applications which are in an early development phase, but you want to be
+able to show to people. See: L<Catalyst::Manual::Deployment::DevelopmentServer>.
 
 =head2 PSGI
 
+Catalyst can be deployed with any PSGI compliant handler. See L<Catalyst::PSGI> for more information,
+and a list of possible deployment servers are shown below:
+
+=head3 Starman
+
+L<Starman> is a high performance pure perl server implementation, which is designed to be used
+directly.
+
+=head3 Starlet.
+
+XXX - FIXME
+
++ other options?
+
+=head3 Twiggy
+
+L<Twiggy> is a high-performance asynchronous web server. It can be used in conjunction with Catalyst,
+but with a number of caveats which mean that it is not suitable for most deployments.
+
 =head1 AUTHORS
 
 Catalyst Contributors, see Catalyst.pm