From a85622b116d43a4acad6ebb45bf1ad9c93d1107a Mon Sep 17 00:00:00 2001 From: Halvor Lund Date: Mon, 3 Jun 2024 12:24:09 +0200 Subject: [PATCH] Improve development docs in readme --- README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.md b/README.md index 8170e17..06dc7a6 100644 --- a/README.md +++ b/README.md @@ -91,3 +91,15 @@ poetry install Remember that when developing a library it is *not* recommended to commit the `poetry.lock` file. + +### Generate docs +To generate docs locally: +- Install required dependencies with `poetry install --with docs`. +- Generate docs with `poetry run make html` in the `docs` folder. + +### Release new version +Press the "Draft new release" button on the [Releases](https://github.com/statnett/linerate/releases) page. +Choose or create an appropriate tag, e.g. `1.2.3`. +Press "Generate release notes" to generate release notes. +Edit Release notes if necessary and press "Publish release". +This causes the publish workflow to run, which publishes the package to PyPI and generates [docs on Github pages](https://statnett.github.io/linerate/).