add mkdocs

[MAfarrag]

Description

• Please include a summary of the change and which issue is fixed.
• Please also include relevant motivation and context.
• List any dependencies that are required for this change.

Issues

• Fixes mkdocs documentations #149
• Fixes docs(mkdocs): migrate from Sphinx/RST to MkDocs Material with GitHub Pages #162
• Fixes docs(docstrings): convert all docstrings from NumPy to Google style #163
• Fixes refactor(typing): modernize type annotations across all modules #164
• Fixes ci(mypy): add mypy type checking to pre-commit and pyproject.toml #165
• Fixes fix(rrm): correct broken method calls and runtime errors #166
• Fixes chore(deps): clean up dependencies and build config #167

Type of change

Check relevant points.

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

How Has This Been Tested?

• Please describe the tests that you ran to verify your changes.

• Provide instructions so we can reproduce.

• Please also list any relevant details for your test configuration

• Test A

• Test B

Checklist:

• updated version number in pyproject.toml
• updated environment.yml and the lock file
• added changes to History.rst
• updated the latest version in README file
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes

[codecov]

Codecov Report

❌ Patch coverage is 81.32530% with 31 lines in your changes missing coverage. Please review.
✅ Project coverage is 56.32%. Comparing base (b97d8f7) to head (f78b1b1).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
src/Hapi/catchment.py	82.43%	13 Missing ⚠️
src/Hapi/rrm/distrrm.py	20.00%	4 Missing ⚠️
src/Hapi/run.py	40.00%	3 Missing ⚠️
src/Hapi/hapi_warnings.py	0.00%	2 Missing ⚠️
src/Hapi/inputs.py	75.00%	2 Missing ⚠️
src/Hapi/rrm/parameters.py	60.00%	2 Missing ⚠️
src/Hapi/wrapper.py	83.33%	2 Missing ⚠️
src/Hapi/parameters/parameters.py	94.11%	1 Missing ⚠️
src/Hapi/routing.py	50.00%	1 Missing ⚠️
src/Hapi/rrm/hbv.py	90.90%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #152      +/-   ##
==========================================
+ Coverage   56.02%   56.32%   +0.29%     
==========================================
  Files          16       17       +1     
  Lines        2140     2173      +33     
==========================================
+ Hits         1199     1224      +25     
- Misses        941      949       +8     

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

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.