Skip to content

Commit ebaf242

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 3112f87 commit ebaf242

File tree

1 file changed

+12
-7
lines changed

1 file changed

+12
-7
lines changed

lib/Dancer2.pm

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

0 commit comments

Comments
 (0)