Skip to content

Commit

Permalink
Revised the sections for sessions and running the app.
Browse files Browse the repository at this point in the history
I more strongly worded the section about the dance keyword in "Running
the application" to further discourage people from using it.

In the sessions section, I listed a couple of session engines that are
suitable for production use to help address any questions about what is
or isn't considered production ready.
  • Loading branch information
cromedome authored and xsawyerx committed Mar 7, 2017
1 parent 3112f87 commit ebaf242
Showing 1 changed file with 12 additions and 7 deletions.
19 changes: 12 additions & 7 deletions lib/Dancer2.pm
Original file line number Diff line number Diff line change
Expand Up @@ -400,13 +400,17 @@ This will create a single application spread across two packages.
=head1 Running an application
There are two ways to run your Dancer2 applications: the old way and the
new way.
You should use L<Plack> to run your application, which is
automatically installed with C<Dancer2>.
The old way (involving the C<dance> keyword) is not recommended (and thus
not documented here), but it is still available for compatibility's sake.
Instead we present the preferred way: using L<Plack>, which is
automatically installed with L<Dancer2>.
=head2 Do not use the C<dance> keyword!
L<Dancer> and early versions of C<Dancer2> used the C<dance> keyword to
run an application. Do B<not> use it to run new applications! The keyword
still exists for compatibility's sake, but its use is discouraged.
L<This Dancer Advent Calendar article|http://advent.perldancer.org/2014/9>
explains the problems inherent in the C<dance> keyword in greater detail.
=head2 Development server
Expand Down Expand Up @@ -1091,7 +1095,8 @@ session. The type is L<Dancer2::Core::Session>.
Note: Dancer comes with a default simple memory-based session engine,
to help you get started. Once you're ready, you should use a
production-level session engine.
production-level session engine, such as L<Dancer2::Session::DBIC>,
L<Dancer2::Session::Memcached>, or L<Dancer2::Session::Redis>.
=head2 Hooks
Expand Down

0 comments on commit ebaf242

Please sign in to comment.