General Development

Continuous Integration / Continuous Development

The Kokkos Tools repository uses CI/CD processes to ensure software stability, robustness and integration within the Kokkos ecosystem. This includes checks for formatting via clang-format. We currently use clang-format version 8, i.e., clang-format-8.

Build Systems

The Kokkos Tools set uses cmake or Makefiles to configure and build Kokkos Tools. You need cmake version 3.16 or higher on your machine. The Kokkos Tools is looking into spack packaging but it is not supported at this time.

Code Formatting

The Kokkos Tools development uses clang-format-8 for code formatting as part of its CI. In your connector, you should have a file .clang-format. You should also run clang-format-8 on your local machine before submitting a PR in order for the CI checks to pass.

Collaboration via Git

Kokkos Tools developers (as well as Kokkos developers) use standard git and GitHub features. We encourage one to review knowledge of git and GitHub if one hasn't done so. In particular, we suggest reviewing the following:

• branching
• committing
• merging
• cherry-picking
• contributing to an existing PR
• rewriting history through git rebase or git reset
• reading status through: git status, git log, and git diff