Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improvements to the base documentation #274

Merged
merged 31 commits into from
Mar 28, 2025
Merged

Improvements to the base documentation #274

merged 31 commits into from
Mar 28, 2025

Conversation

RondeauG
Copy link
Collaborator

@RondeauG RondeauG commented Mar 24, 2025

Pull Request Checklist:

  • This PR addresses an already opened issue (for bug fixes / features)
    • This PR fixes #xyz
  • (If applicable) Documentation has been added / updated (for bug fixes / features).
  • (If applicable) Tests have been added.
  • CHANGELOG.rst has been updated (with summary of main changes).
    • Link to issue (:issue:number) and pull request (:pull:number) has been added.

What kind of change does this PR introduce?

  • Updated the install instruction, which were quite outdated.
  • Added a "Documentation and Support" section to the docs/index.rst file, providing quick access to the GitHub repository, PyPI package, and Conda package.
  • Attempted to see if you still need ESMPy instructions in the Makefile. We'll see...
    This pull request includes various updates to documentation and configuration files aimed at improving clarity, updating dependencies, and ensuring consistent naming conventions. The most important changes are summarized below:

Does this PR introduce a breaking change?

Other information:

  • This automatically staged the deletion of _simple_models which was meant for another PR. This will break the docs and tests, but oh well. We just have to merge this after.

Copy link
Collaborator

@Zeitsperre Zeitsperre left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking good. We should port some of these changes to the cookiecutter!

@github-actions github-actions bot added the approved Approved for additional tests label Mar 24, 2025
RondeauG and others added 18 commits March 24, 2025 16:28
…notebooks (#278)

<!-- Please ensure the PR fulfills the following requirements! -->
<!-- If this is your first PR, make sure to add your details to the
AUTHORS.rst! -->
### Pull Request Checklist:
- [ ] This PR addresses an already opened issue (for bug fixes /
features)
  - This PR fixes #xyz
- [ ] (If applicable) Documentation has been added / updated (for bug
fixes / features).
- [ ] (If applicable) Tests have been added.
- [ ] CHANGELOG.rst has been updated (with summary of main changes).
- [ ] Link to issue (:issue:`number`) and pull request (:pull:`number`)
has been added.

### What kind of change does this PR introduce?

* The optimal interpolation notebook was quite strange, since the first
example was very thorough, but used bad data and, thus, produced bad
results. I removed that example and moved the theory at the start.
* I split the modelling notebook in 2. One for Raven, one for Hydrotel.
* `DummyModel` was dropped. We don't need it anymore and it can be
confusing to have it there at the same level as other models.
* I did the bare minimum to fix the output of the optimal interpolation,
but there is something quite wrong with the code... #277

### Does this PR introduce a breaking change?


### Other information:
<!-- Please ensure the PR fulfills the following requirements! -->
<!-- If this is your first PR, make sure to add your details to the
AUTHORS.rst! -->
### Pull Request Checklist:
- [ ] This PR addresses an already opened issue (for bug fixes /
features)
  - This PR fixes #xyz
- [ ] (If applicable) Documentation has been added / updated (for bug
fixes / features).
- [ ] (If applicable) Tests have been added.
- [ ] CHANGELOG.rst has been updated (with summary of main changes).
- [ ] Link to issue (:issue:`number`) and pull request (:pull:`number`)
has been added.

### What kind of change does this PR introduce?

* Multiple improvements to the text for the notebooks related to GIS
features and frequency analysis.
* I tried to make the GIS notebook smaller in computation time. We will
see if it can now be run on RtD.

### Does this PR introduce a breaking change?

* Many arguments are now literal instead of positional.


### Other information:
@github-actions github-actions bot added the notebooks Run tests against notebooks label Mar 28, 2025
<!-- Please ensure the PR fulfills the following requirements! -->
<!-- If this is your first PR, make sure to add your details to the
AUTHORS.rst! -->
### Pull Request Checklist:
- [ ] This PR addresses an already opened issue (for bug fixes /
features)
  - This PR fixes #xyz
- [ ] (If applicable) Documentation has been added / updated (for bug
fixes / features).
- [ ] (If applicable) Tests have been added.
- [ ] CHANGELOG.rst has been updated (with summary of main changes).
- [ ] Link to issue (:issue:`number`) and pull request (:pull:`number`)
has been added.

### What kind of change does this PR introduce?

* Various improvements to the text within the PMP and Extreme Value
Analysis ntoebooks.

### Does this PR introduce a breaking change?

* Many arguments in `pmp.py` have been made literal instead of
positional.

### Other information:
Copy link

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@RondeauG RondeauG merged commit 394307c into main Mar 28, 2025
17 checks passed
@RondeauG RondeauG deleted the better_doc branch March 28, 2025 23:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Approved for additional tests CI docs notebooks Run tests against notebooks
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants