Contributing guidelines

We welcome community contributions to oneCCL. You can:

Refer to our guidelines on pull requests and isssues before you proceed.

Issues

Use GitHub issues to:

Note: To report a vulnerability, refer to Intel vulnerability reporting policy.

Before you submit a pull request, make sure that:

You follow our code contribution guidelines and our coding style.
You provided the requested details for new primitives or extended the existing unit tests when fixing an issue.

Note: This project follows the GitHub flow. To get started with pull requests, see GitHub howto.

It is strongly advised to open an RFC (request for comments) pull request when contributing new primitives. Please provide the following details:

The definition of the operation as a oneCCL primitive. It should include an interface and semantics. We welcome sketches for the interface, but the semantics should be fairly well-defined.
A use case, including a model and parallelism scenario.

The code must be:

Tested: oneCCL uses gtests for lightweight functional testing.
Documented: oneCCL uses Doxygen for inline comments in public header files that are used to build the API reference and reStructuredText for the Developer Guide. See oneCCL documentation for reference.
Portable: oneCCL supports CPU and GPU architectures as well as different compilers and run-times. The new code should be complaint with the System Requirements.

The general principle is to follow the style of existing or surrounding code.

Be sure to extend the existing tests when fixing an issue.