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

Create 0.4.0 release #136

Open
6 of 32 tasks
veenstrajelmer opened this issue Sep 9, 2024 · 0 comments
Open
6 of 32 tasks

Create 0.4.0 release #136

veenstrajelmer opened this issue Sep 9, 2024 · 0 comments

Comments

@veenstrajelmer
Copy link
Collaborator

veenstrajelmer commented Sep 9, 2024

The code quality, test coverage and user friendliness was improved in 0.2.0 and the output format was improved in 0.3.0. Several steps are required for the results to be official (e.g. updates in measurement data and automatic retrieval of HYDRA statistics). These dependencies might only be resolved in 2025.

Todo:

Later (2025):

Todo not related to methods:

  • check warnings in pytest workflow
  • move to Deltares Github organization?
  • decide on dutch/english in documentation, docstrings, function/argument/key/variable names
  • generate DOI and add badge to readme
  • GPL or LGPL license? Default of Deltares-research is MIT, not for Deltares
  • code is formatted with black, do this automatically via .pre_commit_config.yml?
  • add contributing docs (including release workflow)
  • publish to database instead of csv's? Makes it possible to add metadata like unit, station x/y/code/name, vertref, kenmerkendewaarden-package-version etc. Temporarily add to Deltares database, or wait for RWS database to be consolidated?

Reporting:

  • rapportage evt met Quarto: iets online via bookdown R of opvolger, een webpage of pdf. Mooie methode voor technische rapporten, kan ook met Deltares LaTeX template: https://www.testsysteemrapportage.nl/wadden/_main.pdf Of gewoon sphinx docs op github?
  • docstrings do/will contain the technical user information about input/output of functions and what they do
  • the description of the kenmerkende waarden can be in sphinx documentation (what does it represent, why this method, interaction)
  • additionally a pdf report with description of historic methods and motivation of improvements/simplification? Maybe including comparison of methods if still reproducible This information is not all relevant for the online documentation, since not all users will be interested in this. But it is good to document motivation for changes somewhere.
  • which language where?
  • the RWS dashboard will show the results for all stations, so here we can focus on one example station (or some)
  • also document which output (csv files, figures, boi timeseries) is relevant for which process (including contact person)

Products:

  • github toolbox
  • final results
  • report?
@veenstrajelmer veenstrajelmer mentioned this issue Sep 11, 2024
9 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant