=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.
+
+The DSL (mini-language) for query composition is only partially explained there,
+see L<SQL::Abstract/WHERE CLAUSES> for the complete details.
+
+=item L< C<$schema>::Result::C<$resultclass>|DBIx::Class::Manual::ResultClass>
+- Classes representing a single result (row) from a DB query.
-=item L<DBIx::Class::ResultSet> - Selecting and manipulating sets.
+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.
=item L<DBIx::Class::ResultSetColumn> - Perform operations on a single column of a ResultSet.
=item L<DBIx::Class::ResultSource> - Source/Table definition functions.
-=item L<DBIx::Class::Schema> - Overall sourcess, and connection container.
+=item L<DBIx::Class::Schema> - Overall sources, and connection container.
=item L<DBIx::Class::Relationship> - Simple relationship declarations.