How to contribute

Adding a feature or bugfix to Valtimo

1. Create an issue in the Valtimo issues repository to discuss your contribution. This is to reduce the work that is required, as it can both reduce the chances of feedback and allows for the Valtimo team to provide some pointers on how to proceed.

2. Implement the feature/bugfix and create a PR to the development branch. No reviewers are necessary.

   • Instructions on how to run Valtimo locally is split into Valtimo core and GZAC for backend-libraries, which can be found here and here respectively. For instructions on how to run the frontend-libraries, see here.

3. Write release notes and documentation for the feature. See below for instructions on how to do this.

4. Merge the branch after getting an approval from the Valtimo team.

Adding documentation to Valtimo

There are two different circumstances for which documentation for Valtimo can be written. Either because it is related to a particular change in the product that will be included in an upcoming release, or to add something to the documentation that is not related to an upcoming release (e.g. fixing spelling errors, or documenting part of an already existing feature).

Writing documentation related to an upcoming release

1. Write documentation/release notes. These should be written as a PR for this repository. There should already be a branch for the upcoming Valtimo release (e.g. feature/release-notes-9.17.0). Make a branch from that branch, and do not forget to merge it back into that Valtimo release branch as part of the PR, add all team Valtimo developers to this PR as reviewers.

   • Information on what language to use, as well as general guidelines can be found here.

   • Release notes to in the release-notes package.

   • If new pages are added, these should also be added to SUMMARY.md. The sidebar shown on GitBook corresponds to this structure.

2. Merge the branch after getting an approval from the Valtimo team.

Writing documentation unrelated to an upcoming release

1. In case of a new page, discuss the documentation you want to write with someone from the Valtimo team.

2. Write documentation. This should be written as a PR for this repository. Make a branch from the main branch, add all team Valtimo developers to this PR as reviewers.

3. Merge the branch after getting an approval from the Valtimo team.