-=head1 USER MANUAL
+=head1 NAME
+
+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
=head1 SECTIONS
-=over 4
+=head2 L<DBIx::Class::Manual::SchemaIntro>
-=item L<DBIx::Class::Manual::Intro>
+Beginner guide to using DBIx::Class with the schema interface. This is the
+recommended way to use DBIx::Class.
-A beginner's introduction to using the native DBIx::Class interface
+=head2 L<DBIx::Class::Manual::Intro>
-=item L<DBIx::Class::Manual::Cookbook>
+Beginner guide to using DBIx::Class with the older class-based interface.
+This is included for the sake of completeness - you are recommended to
+use the schema-based interface instead.
+
+=head2 L<DBIx::Class::Manual::Cookbook>
Convenient reciepes for DBIC usage.
-=item L<DBIx::Class::Manual::FAQ>
+=head2 L<DBIx::Class::Manual::FAQ>
Frequently asked questions about DBIC.
-=item L<DBIx::Class::Manual::Troubleshooting>
+=head2 L<DBIx::Class::Manual::Troubleshooting>
Got trouble? Let us shoot it for you.
-=back
-
If you're using the CDBI Compat layer, we suggest reading the L<Class::DBI>
documentation. It should behave the same way.