X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDBIx%2FClass%2FManual.pod;h=393ee5368236e8f0432ae6376c4e9fd65f48d6d4;hb=def81720ba4d78afebcfd164cd977af555297d23;hp=f95b8aa83002741a6146d4b23b86b3f16770c9eb;hpb=bfab575afa37545ee175b824cea554c9c37ab6f5;p=dbsrgits%2FDBIx-Class.git

diff --git a/lib/DBIx/Class/Manual.pod b/lib/DBIx/Class/Manual.pod
index f95b8aa..393ee53 100644
--- a/lib/DBIx/Class/Manual.pod
+++ b/lib/DBIx/Class/Manual.pod
@@ -11,26 +11,29 @@ from your SQL database.
 
 =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.