ci: Adds numpydoc-validation to pre-commit hooks

[ns-rse]

Closes #39

• Adds the numpydoc-validation pre-commit hook.
• Tidies up all docstrings in current codebase (may want to revisit those in pending PRs Add file type: SPM #33, Add file type: IBW #34 and Add file type: JPK #36).
• Ignores commit where changes to docstrings are made.
• Updates configuration of ruff in pyproject.toml.

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 91.66667% with 1 lines in your changes are missing coverage. Please review.

Project coverage is 67.69%. Comparing base (f282c31) to head (3c045c4).
Report is 103 commits behind head on main.

Files	Patch %	Lines
topofileformats/asd.py	91.66%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main      #40      +/-   ##
==========================================
+ Coverage   65.87%   67.69%   +1.82%     
==========================================
  Files           3        6       +3     
  Lines         337      452     +115     
==========================================
+ Hits          222      306      +84     
- Misses        115      146      +31     

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

[ns-rse]

@SylviaWhittle thanks for spotting my tpyo, corrected.

The pre-commit.ci is failing but that is to be expected as it runs the new hook numpydoc-validation against the main branch which includes your recently merged jpk/ibw/spm modules.

I'll tidy these up in a separate PR (most of them are simple and things like spacing before a colon in the docstring which makes it appear as though parameters aren't documented or starting description on a new line).

[SylviaWhittle]

Thanks @ns-rse, this will help in slowly improving our code & documentation. I'll also endeavour to provide examples in docstrings when writing new functions.