diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 51116d4b192da7..065a190dc743ff 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -33,7 +33,7 @@ Please do not: * **DON'T** submit PRs that alter licensing related files or headers. If you believe there's a problem with them, file an issue and we'll be happy to discuss it. * **DON'T** add API additions without filing an issue and discussing with us first. See [API Review Process](docs/project/api-review-process.md). -## Managed Code Compatibility +## Breaking Changes Contributions must maintain [API signature](docs/coding-guidelines/breaking-changes.md#bucket-1-public-contract) and behavioral compatibility. Contributions that include [breaking changes](docs/coding-guidelines/breaking-changes.md) will be rejected. Please file an issue to discuss your idea or change if you believe that it may affect managed code compatibility. @@ -52,6 +52,7 @@ We use and recommend the following workflow: - Name the branch so that it clearly communicates your intentions, such as issue-123 or githubhandle-issue. - Branches are useful since they isolate your changes from incoming changes from upstream. They also enable you to create multiple PRs from the same fork. 4. Make and commit your changes to your branch. + - [Workflow Instructions](docs/workflow/README.md) explains how to build and test. - Please follow our [Commit Messages](#commit-messages) guidance. 5. Add new tests corresponding to your change, if applicable. 6. Build the repository with your changes.