Clarify interface

[janbridley]

Description

Parameterless "read_*" methods have been changed to properties with simplified names, and getitem now returns matches from both pairs and loops

Types of Changes

• Documentation update
• Bug fix
• New feature
• Breaking change¹

¹The change breaks (or has the potential to break) existing functionality and should be merged into the breaking branch

Checklist:

• I am familiar with the Development Guidelines
• The changes introduced by this pull request are covered by existing or newly introduced tests.
• I have updated the changelog and added my name to the credits.