ukaea / ukaea/PROCESS

Improve documentation for testing and the Process test suite

Open
#1,552 1 comment 0 reactions 1 assignee View on GitHub

@timothy-nunn is already working on this.

Since Jul 7, 2023.

Documentation
Dominant language
Python
Stars
71
Forks
27
Avg merge
2d 18h
Merged PRs (30d)
33

Description

In GitLab by @timothy-nunn on Feb 1, 2022, 09:32

In discussion with @j-a-foster yesterday, it was clear that the --overwrite flag could benefit from additional information in their documentation.

I propose the following changes to the documentation around testing:

  • A page/section around writing tests
  • A page/section around using Pytest (e.g. -k)
  • A page/section around using the Process test suite (e.g. overwrite and tolerance), updating hardcoded tests, and how to tell if your regression/integration failures are acceptable.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.