X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDBIx%2FClass%2FManual%2FDocMap.pod;h=b6eaa25aeaf6c23a7a65556f702156f22dba30fd;hb=6b5b5d07d678d6d6ba2d227c2de3fa169b7b8d24;hp=5820d03ca8bf918496aba2546b2529e0cc9e94c6;hpb=85f7862264752290ed6e3a3bf020f907a2cdd6fc;p=dbsrgits%2FDBIx-Class.git

diff --git a/lib/DBIx/Class/Manual/DocMap.pod b/lib/DBIx/Class/Manual/DocMap.pod
index 5820d03..b6eaa25 100644
--- a/lib/DBIx/Class/Manual/DocMap.pod
+++ b/lib/DBIx/Class/Manual/DocMap.pod
@@ -8,64 +8,55 @@ DBIx::Class::Manual::DocMap - What documentation do we have?
 
 =item L<DBIx::Class::Manual> - User's Manual overview.
 
-=item L<DBIx::Class::Manual::FAQ> - Frequently Asked Questions, gathered from IRC and the mailing list.
-
-=item L<DBIx::Class::Manual::Intro> - Introduction to setting up and using DBIx::Class.
+=item L<DBIx::Class::Manual::QuickStart> - Up and running with DBIC in 10 minutes.
 
-=item L<DBIx::Class::Manual::Example> - Full example Schema.
+=item L<DBIx::Class::Manual::Intro> - More detailed introduction to setting up and using DBIx::Class.
 
-=item L<DBIx::Class::Manual::Cookbook> - Various short recipes on how to do things.
+=item L<DBIx::Class::Manual::SQLHackers> - How to use DBIx::Class if you know SQL (external, available on CPAN)
 
-=item L<DBIx::Class::Manual::Troubleshooting> - What to do if things go wrong (diagnostics of known error messages).
+=item L<DBIx::Class::Manual::Joining> - Joining tables with DBIx::Class.
 
-=item L<DBIx::Class::Manual::Component> - How to write your own DBIx::Class components.
+=item L<DBIx::Class::Manual::Features> - A boatload of DBIx::Class features with links to respective documentation.
 
 =item L<DBIx::Class::Manual::Glossary> - What do all those terms mean?
 
-=back
-
-=head1 Setting up
-
-=over 4
-
-=item L<DBIx::Class::Schema> - Overall schemas, and connection container.
-
-=item L<DBIx::Class::ResultSource> - Source/Table definition functions.
-
-=item L<DBIx::Class::Relationship> - Simple relationships.
-
-=item L<DBIx::Class::Relationship::Base> - Relationship details.
+=item L<DBIx::Class::Manual::Cookbook> - Various short recipes on how to do things.
 
-=item L<DBIx::Class::PK::Auto> - Magically retrieve auto-incrementing fields.
+=item L<DBIx::Class::Manual::FAQ> - Frequently Asked Questions, gathered from IRC and the mailing list.
 
-=item L<DBIx::Class::Core> - Set of standard components to load.
+=item L<DBIx::Class::Manual::Troubleshooting> - What to do if things go wrong (diagnostics of known error messages).
 
-=item L<DBIx::Class::Serialize::Storable> - ?
+=back
 
-=item L<DBIx::Class::InflateColumn> - Making objects out of your columns.
+=head1 Some essential reference documentation
 
-=item L<DBIx::Class::InflateColumn::DateTime> - Magically turn your datetime or timestamp columns into DateTime objects.
+The first two list items are the most important.
 
-=item L<DBIx::Class::PK> - Dealing with primary keys.
+=over 4
 
-=item L<DBIx::Class::ResultSourceProxy::Table> - Turns the resultsource into a table.
+=item L<DBIx::Class::ResultSet/search> - Selecting and manipulating sets.
 
-=item L<DBIx::Class::AccessorGroup> - Accessor grouping.
+The DSL (mini-language) for query composition is only partially explained there,
+see L<SQL::Abstract/WHERE CLAUSES> for the complete details.
 
-=back
+=item L<C<$schema>::Result::C<$resultclass>|DBIx::Class::Manual::ResultClass>
+- Classes representing a single result (row) from a DB query.
 
-=head1 Retrieving and creating data
+Such classes normally subclass L<DBIx::Class::Core>, the methods inherited
+from L<DBIx::Class::Row|DBIx::Class::Row/METHODS> and
+L<DBIx::Class::Relationship::Base|DBIx::Class::Relationship::Base/METHODS>
+are used most often.
 
-=over 4
+=item L<DBIx::Class::ResultSetColumn> - Perform operations on a single column of a ResultSet.
 
-=item L<DBIx::Class::ResultSet> - Selecting and manipulating sets.
+=item L<DBIx::Class::ResultSource> - Source/Table definition functions.
 
-=item L<DBIx::Class::ResultSetColumn> - Perform operations on entire columns of a ResultSet.
+=item L<DBIx::Class::Schema> - Overall sources, and connection container.
 
-=item L<DBIx::Class::Row> - Dealing with actual data.
+=item L<DBIx::Class::Relationship> - Simple relationship declarations.
 
-=item L<DBIx::Class::Storage> - Basic Storage stuff.
+=item L<DBIx::Class::Relationship::Base> - Relationship declaration details.
 
-=item L<DBIx::Class::Storage::DBI> - Storage using L<DBI> and L<SQL::Abstract>.
+=item L<DBIx::Class::InflateColumn> - Making objects out of your column values.
 
 =back