Skip to content

Commit e949b24

Browse files
cromedomexsawyerx
authored andcommitted
Revised the sections for sessions and running the app.
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.
1 parent 1d902a2 commit e949b24

File tree

1 file changed

+12
-7
lines changed

1 file changed

+12
-7
lines changed

lib/Dancer2.pm

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -401,13 +401,17 @@ This will create a single application spread across two packages.
401401
402402
=head1 Running an application
403403
404-
There are two ways to run your Dancer2 applications: the old way and the
405-
new way.
404+
You should use L<Plack> to run your application, which is
405+
automatically installed with C<Dancer2>.
406406
407-
The old way (involving the C<dance> keyword) is not recommended (and thus
408-
not documented here), but it is still available for compatibility's sake.
409-
Instead we present the preferred way: using L<Plack>, which is
410-
automatically installed with L<Dancer2>.
407+
=head2 Do not use the C<dance> keyword!
408+
409+
L<Dancer> and early versions of C<Dancer2> used the C<dance> keyword to
410+
run an application. Do B<not> use it to run new applications! The keyword
411+
still exists for compatibility's sake, but its use is discouraged.
412+
413+
L<This Dancer Advent Calendar article|http://advent.perldancer.org/2014/9>
414+
explains the problems inherent in the C<dance> keyword in greater detail.
411415
412416
=head2 Development server
413417
@@ -1092,7 +1096,8 @@ session. The type is L<Dancer2::Core::Session>.
10921096
10931097
Note: Dancer comes with a default simple memory-based session engine,
10941098
to help you get started. Once you're ready, you should use a
1095-
production-level session engine.
1099+
production-level session engine, such as L<Dancer2::Session::DBIC>,
1100+
L<Dancer2::Session::Memcached>, or L<Dancer2::Session::Redis>.
10961101
10971102
=head2 Hooks
10981103

0 commit comments

Comments
 (0)