=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
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
=head1 FastCGI Deployment
FastCGI is a high-performance extension to CGI. It is suitable
-for production environments.
+for production environments, and is the standard method for deploying Catalyst
+in shared hosting environments.
=head2 Pros
See below for the specific web server configurations for using the external
server.
+=head1 WEB SERVERS
+
+Any web server which supports FastCGI should work with Catalyst. Configuration recipies for
+well-known web servers are linked below, and we would welcome contributions from people
+deploying Catalyst against other web servers.
+
+=head2 Apache
+
+L<Catalyst::Manual::Deployment::Apache::FastCGI>
+
+=head2 nginx
+
+L<Catalyst::Manual::Deployment::nginx::FastCGI>
+
+=head2 lighttpd
+
+L<Catalyst::Manual::Deployment::lighttpd::FastCGI>
+
+=head2 Microsoft IIS
+
+L<Catalyst::Manual::Deployment::IIS::FastCGI>
+
=head1 AUTHORS
Catalyst Contributors, see Catalyst.pm