PLT-7891 Add a few docstrings to the indexers

[berewt]

Should clarify how to handle the collaboration of WithCatchup and WithTransform to filter events.

Pre-submit checklist:

• Branch
  • Tests are provided (if possible)
  • Commit sequence broadly makes sense and have useful messages
  • Important changes are reflected in changelog.d of the affected packages
  • Relevant tickets are mentioned in commit messages
• PR
  • (For external contributions) Corresponding issue exists and is linked in the description
  • Targeting main unless this is a cherry-pick backport
  • Self-reviewed the diff
  • Useful pull request description
  • If relevant, reference the ADR in the PR and reference the PR in the ADR
  • Reviewer requested