From: Lars Dɪᴇᴄᴋᴏᴡ 迪拉斯 <daxim@cpan.org>
Date: Sun, 24 Mar 2013 12:07:24 +0000 (+0100)
Subject: point out where in the docs a user is most likely to spend reading time
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=d71502bd0ca6c125b14e7a9d4786f7deae3e6fb2;p=dbsrgits%2FDBIx-Class-Historic.git

point out where in the docs a user is most likely to spend reading time
---

diff --git a/lib/DBIx/Class/Manual/DocMap.pod b/lib/DBIx/Class/Manual/DocMap.pod
index 83c9633..13ffa78 100644
--- a/lib/DBIx/Class/Manual/DocMap.pod
+++ b/lib/DBIx/Class/Manual/DocMap.pod
@@ -26,11 +26,15 @@ DBIx::Class::Manual::DocMap - What documentation do we have?
 
 =head1 Some essential reference documentation
 
+The first two list items are the most important.
+
 =over 4
 
-=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::ResultSet/search> - Selecting and manipulating sets.
 
-=item L<DBIx::Class::ResultSet> - Selecting and manipulating sets.
+=item L<DBIx::Class::$resultclass (normally based on DBIx::Class::Core)|DBIx::Class::Manual::ResultClass>
+- Representing a single result (row) from a DB query. The methods inherited from
+L<DBIx::Class::Row> and L<DBIx::Class::Relationship::Base> are used most often.
 
 =item L<DBIx::Class::ResultSetColumn> - Perform operations on a single column of a ResultSet.
 
diff --git a/lib/DBIx/Class/ResultSet.pm b/lib/DBIx/Class/ResultSet.pm
index fe00753..c6935c3 100644
--- a/lib/DBIx/Class/ResultSet.pm
+++ b/lib/DBIx/Class/ResultSet.pm
@@ -305,7 +305,7 @@ call it as C<search(undef, \%attrs)>.
 For a list of attributes that can be passed to C<search>, see
 L</ATTRIBUTES>. For more examples of using this function, see
 L<Searching|DBIx::Class::Manual::Cookbook/Searching>. For a complete
-documentation for the first argument, see L<SQL::Abstract>
+documentation for the first argument, see L<SQL::Abstract/"WHERE CLAUSES">
 and its extension L<DBIx::Class::SQLMaker>.
 
 For more help on using joins with search, see L<DBIx::Class::Manual::Joining>.