Thank you for your interest in contributing to MaterialX! This document explains our contribution process and procedures.
There are two primary ways to connect with the MaterialX community:
- The MaterialX channel of the Academy Software Foundation Slack. This platform is appropriate for general questions, feature requests, and discussion of the MaterialX project as a whole. You can request an invitation to join the Academy Software Foundation Slack at https://slack.aswf.io/.
- The Issues panel of the MaterialX GitHub, which is used to report and discuss bugs and build issues.
To contribute to MaterialX, you must sign a Contributor License Agreement through the EasyCLA system, which is integrated with GitHub as a pull request check.
Prior to submitting a pull request, you can sign the form through this link. If you submit a pull request before the form is signed, the EasyCLA check will fail with a red NOT COVERED message, and you'll have another opportunity to sign the form through the provided link.
- If you are an individual writing the code on your own time and you're sure you are the sole owner of any intellectual property you contribute, you can sign the CLA as an Individual Contributor.
- If you are writing the code as part of your job, or if your employer retains ownership to intellectual property you create, then your company's legal affairs representatives should sign a Corporate Contributor License Agreement. If your company already has a signed CCLA on file, ask your local CLA manager to add you to your company's approved list.
The MaterialX CLAs are the standard forms used by Linux Foundation projects and recommended by the ASWF TAC.
Please follow the coding convention and style in each file and in each library when adding new files. For convenience, you can use the included clang-format file to automatically align new source files with MaterialX coding conventions.