Home

Welcome to the BLOM wiki!

This wiki is mainly documenting how to work with the BLOM repository with git and GitHub.

See NorESM documentation for BLOM user documentation.

---

Contributing to BLOM/iHAMOCC

We welcome contributions to the BLOM/iHAMOCC model system, including bug reports and fixes, suggestions/contributions for code improvements, and suggestions for feature enhancements or inclusion of new features.

1. Create an issue to describe the problem and/or suggested fix.
   • In case of feature enhancements or new features, discuss if a separate feature branch should be created.
2. Fork the repository if you wish to contribute code.
3. Submit changes for review through pull requests.
   • Check that the pull request does not create conflicts. In case of conflicts, try to fix this in the pull request, or ask a maintainer for advice.
   • Changes to the master branch should be reviewed by at least one of the maintainers (other than the one submitting the pull request)

Forking workflow

Developers should mainly use a forking workflow for contributions to BLOM/iHAMOCC, as this encourages regular code review of all changes. The forking layout we aim for is described in this coderefienry instruction page.