DOC: Minor readability increases

[j-t-1]

1. Sort the API reference, de-emphasizing the deprecated PdfMerger.
2. Add new lines to .pre-commit-config.yaml.

[j-t-1]

1. "The PdfReader Class" could be renamed to just "PdfReader". Similarly for the others, so removing "The" and "Class" to reduce noise.
2. Not related to readability, but is this file needed: /pypdf/py.typed?

[stefan6419846]

Not related to readability, but is this file needed: /pypdf/py.typed?

Yes, this indicates that we provide typing information for type checkers.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 94.54%. Comparing base (29683d3) to head (b036ad3).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #2515   +/-   ##
=======================================
  Coverage   94.54%   94.54%           
=======================================
  Files          49       49           
  Lines        8173     8173           
  Branches     1658     1658           
=======================================
  Hits         7727     7727           
  Misses        276      276           
  Partials      170      170           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[j-t-1]

Not related to readability, but is this file needed: /pypdf/py.typed?

Yes, this indicates that we provide typing information for type checkers.

Useful to know.
Thoughts on renaming "The PdfReader Class" to "PdfReader" to reduce noise?

[stefan6419846]

I do not think that this is required - these are the API docs which provide details to the developer and thus might be more verbose. Additionally, it makes it easier to differentiate between modules and classes (although PEP8 naming might already indicate this, but better explicit than implicit).