2.1 KiB
Contributing
There are many ways that you can contribute to the Azure OpenAPI Validation Tools project:
- Submit a bug
- Submit a code fix for a bug
- Submit additions or modifications to the documentation
- Submit a feature request
All code submissions will be reviewed and tested by the team, and those that meet a high bar for both quality and design/roadmap appropriateness will be merged into the project.
Getting the Code
Make sure you're running Node.js 14+ and NPM 8+, to verify and upgrade NPM do:
node --version
npm --version
npm i -g npm@latest
Clone this repository
git clone https://github.com/azure/oav
cd oav
Install dependencies
npm ci
Build the project
npm run build
Run the tests
To run all tests in the project
npm test
To run all the tests in a particular test file:
npm run jest <test-file-name>
Creating a pull request
Always open one pull request per issue and link the issue in the pull request description. If there is no preexisting issue for your pull request, please create one.
To create a pull request, please:
- Create a branch and add your changes. Make sure you include appropriate tests and documentation.
- Ensure all the tests pass:
npm test
- Check for lint errors and fix any that are reported:
npm run lint
andnpm run lint-fix
- Commit your changes using a minimum of individual commits. Squash/fixup commits as needed.
- Push to your fork and submit a pull request to the develop branch. Reference the issue that describes the problem or feature and include a summary of your changes, noting any significant design decisions.
- Reviewers will be added to your PR automatically and if the PR is approved will merge it.
Code of Conduct
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.