=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.