feat: use pydoclint as a documentation linter

[ireneisdoomed]

Checks between a function's arguments and types and its docstrings were lost in the transition to Ruff.
It is in Ruff's plans to bring this functionality (issue), but they haven't started yet.
For the time being I propose using pydoclint, a high performance alternative to darglint (the tool that flake8 relied on).

This PR contains:

• addition and configuration of pydoclint to the project
  • used their cli options as a reference
• addition of docstring linting to the make check rule
• addition to pydoclint as one of the pre commit hooks
  • used https://jsh9.github.io/pydoclint/#23-as-a-pre-commit-hook as a reference
• several fixes of all issues raised in pydoclint in our project
• a change in tests/airflow/test_dag.py to comment out a failing test test_no_import_errors
  • this is raised due to an environment discrepancy between the test (which reads the module relative to the rest of the project) and airflow (which resolves the DAG independently of the project)

[codecov-commenter]

Codecov Report

Merging #212 (c2ffd01) into main (8525981) will increase coverage by 0.01%.
The diff coverage is 94.44%.

@@            Coverage Diff             @@
##             main     #212      +/-   ##
==========================================
+ Coverage   89.55%   89.57%   +0.01%     
==========================================
  Files          69       69              
  Lines        1446     1448       +2     
==========================================
+ Hits         1295     1297       +2     
  Misses        151      151              

Files	Coverage Δ
src/conftest.py	100.00% <100.00%> (ø)
src/otg/common/Liftover.py	80.64% <100.00%> (ø)
src/otg/common/schemas.py	100.00% <ø> (ø)
src/otg/common/session.py	69.44% <100.00%> (ø)
src/otg/common/spark_helpers.py	100.00% <ø> (ø)
src/otg/common/utils.py	82.14% <100.00%> (ø)
src/otg/dataset/colocalisation.py	100.00% <ø> (ø)
src/otg/dataset/dataset.py	82.69% <100.00%> (ø)
src/otg/dataset/gene_index.py	100.00% <ø> (ø)
src/otg/dataset/intervals.py	64.28% <ø> (ø)
... and 23 more

[d0choa]

Great