-=head1 USER MANUAL
+=head1 NAME
-This is the L<DBIx::Class> users manual. DBIx::Class is a SQL->OOP mapper.
+DBIx::Class::Manual - Index of the Manual
+
+=head1 DESCRIPTION
+
+This is the L<DBIx::Class> users manual. DBIx::Class is a SQL->OOP mapper.
This means that it can represent your SQL tables as perl classes, and give
you convenient accessors and methods for retrieving and updating information
from your SQL database.
=head1 SECTIONS
-=over 4
+=head2 L<DBIx::Class::Manual::FAQ>
-=item L<DBIx::Class::Manual::Intro>
+Short answers and doc pointers to questions.
-A beginner's introduction to using the native DBIx::Class interface
+=head2 L<DBIx::Class::Manual::Glossary>
-=item L<DBIx::Class::Manual::Cookbook>
+Explanations of terms used in this documentation.
-Convenient reciepes for DBIC usage.
+=head2 L<DBIx::Class::Manual::Intro>
-=item L<DBIx::Class::Manual::FAQ>
+Beginner guide to using DBIx::Class.
-Frequently asked questions about DBIC.
+=head2 L<DBIx::Class::Manual::Example>
-=item L<DBIx::Class::Manual::Troubleshooting>
+An example of slightly more complex usage.
-Got trouble? Let us shoot it for you.
+=head2 L<DBIx::Class::Manual::Joining>
+
+How to translate known SQL JOINs into DBIx-Class-ish.
+
+=head2 L<DBIx::Class::Manual::Cookbook>
+
+Convenient recipes for DBIC usage.
+
+=head2 L<DBIx::Class::Manual::Reading>
-=back
+How to read (and write) the reference documentation.
+
+=head2 L<DBIx::Class::Manual::DocMap>
+
+Lists of modules by task to help you find the correct document.
+
+=head2 L<DBIx::Class::Manual::Troubleshooting>
+
+Got trouble? Let us shoot it for you.
If you're using the CDBI Compat layer, we suggest reading the L<Class::DBI>
documentation. It should behave the same way.
+=head2 L<DBIx::Class::Manual::Component>
+
+Existing components, and documentation and example on how to
+develop new ones.
+
=cut