From: Peter Rabbitson <ribasushi@cpan.org>
Date: Tue, 5 Mar 2013 05:22:24 +0000 (+0100)
Subject: Reorganize and freshen up the DocMap
X-Git-Tag: v0.08210~29
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=54e4be9216e440bd0bd91050c36115d2911fd8a0;hp=06752a03d716bf4b257c448b07cccae4ca519e13;p=dbsrgits%2FDBIx-Class.git

Reorganize and freshen up the DocMap

It accumulated lots of stuff that is confusing / not relevant for beginners
---

diff --git a/lib/DBIx/Class/Manual/DocMap.pod b/lib/DBIx/Class/Manual/DocMap.pod
index c9bd1d8..83c9633 100644
--- a/lib/DBIx/Class/Manual/DocMap.pod
+++ b/lib/DBIx/Class/Manual/DocMap.pod
@@ -12,7 +12,7 @@ DBIx::Class::Manual::DocMap - What documentation do we have?
 
 =item L<DBIx::Class::Manual::Example> - Full example Schema.
 
-=item L<DBIx::Class::Manual::SQLHackers::TOC> - How to use DBIx::Class if you know SQL (external, available on CPAN)
+=item L<DBIx::Class::Manual::SQLHackers> - How to use DBIx::Class if you know SQL (external, available on CPAN)
 
 =item L<DBIx::Class::Manual::Glossary> - What do all those terms mean?
 
@@ -22,50 +22,26 @@ DBIx::Class::Manual::DocMap - What documentation do we have?
 
 =item L<DBIx::Class::Manual::Troubleshooting> - What to do if things go wrong (diagnostics of known error messages).
 
-=item L<DBIx::Class::Manual::Component> - How to write your own DBIx::Class components.
-
 =back
 
-=head1 Setting up
+=head1 Some essential reference documentation
 
 =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::PK::Auto> - Magically retrieve auto-incrementing fields.
-
-=item L<DBIx::Class::Core> - Set of standard components to load.
-
-=item L<DBIx::Class::InflateColumn> - Making objects out of your columns.
-
-=item L<DBIx::Class::InflateColumn::DateTime> - Magically turn your datetime or timestamp columns into DateTime objects.
+=item L<DBIx::Class::$resultclass (normally based on DBIx::Class::Core)|DBIx::Class::Manual::ResultClass> - Representing a single result (row) from a DB query
 
-=item L<DBIx::Class::PK> - Dealing with primary keys.
-
-=item L<DBIx::Class::ResultSourceProxy::Table> - Turns the resultsource into a table.
-
-=item L<DBIx::Class::AccessorGroup> - Accessor grouping.
-
-=back
-
-=head1 Retrieving and creating data
+=item L<DBIx::Class::ResultSet> - Selecting and manipulating sets.
 
-=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 sourcess, 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