=head1 MULTIPLE BACKENDS
-B<NOTE> This is documentation for the old store system. This is not how the new realm-based stores
-work. Nobody has managed to rewrite this part of the documentation yet.
+B<NOTE> This is documentation for the old store system used in versions of
+L<Catalyst::Plugin::Authentication> prior to 0.10. This is NOT how the
+new realm-based stores work. This is here for reference only.
+
See L<Catalyst::Plugin::Authentication::Internals> instead.
+=head1 OLD STORE DOCUMENTATION BELOW
+
A key issue to understand about authentication stores is that there are
potentially many of them. Each one is registered into the application, and has
a name.