X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDBIx%2FClass%2FManual.pod;h=3585941e699545d9346bc6e732d633e0a25f1c55;hb=997a3638a92234ac9f0a1a49984110cb73fb4dbb;hp=e2ccafb8e5ddedb3f3421b1e6b523c77950f994e;hpb=9c82c181a7b1f976a31902c5a7d0800b8648b122;p=dbsrgits%2FDBIx-Class.git

diff --git a/lib/DBIx/Class/Manual.pod b/lib/DBIx/Class/Manual.pod
index e2ccafb..3585941 100644
--- a/lib/DBIx/Class/Manual.pod
+++ b/lib/DBIx/Class/Manual.pod
@@ -1,8 +1,8 @@
-=head1 NAME
+=head1 NAME 
 
-DBIx::Class::Manual
+DBIx::Class::Manual - Index of the Manual
 
-=head1 USER 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
@@ -11,28 +11,49 @@ 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>
+
+How to read (and write) the reference documentation.
 
-=back
+=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