=head1 NAME DBIx::Class::Manual::Reading - How to read and write
DBIx::Class POD. =head1 DESCRIPTION This doc should help users
to understand how the examples and documentation found in the L
distribution can be interpreted. Writers of DBIx::Class POD
should also check here to make sure their additions are
consistent with the rest of the documentation. =head1 METHODS
Methods should be documented in the files which also contain the
code for the method, or that file should be hidden from PAUSE
completely, in which case the methods are documented in the file
which loads it. Methods may also be documented and referred to
in files representing the major objects or components on which
they can be called. For example, L documents the methods
actually coded in the helper relationship classes like
DBIx::Class::Relationship::BelongsTo. The BelongsTo file itself
is hidden from PAUSE as it has no documentation. The accessors
created by relationships should be mentioned in L, the major
object that they will be called on.