Skip to content

Latest commit

 

History

History
68 lines (48 loc) · 3.32 KB

CONTRIBUTING.md

File metadata and controls

68 lines (48 loc) · 3.32 KB

Contributing guidelines

Welcome to AWS Docs! We thrive on your contribution. ❤️

Get started

Please take a moment to familiarize yourself with the following:

  1. Working with issues
  2. Authoring code
  3. Disclaimers

Working with issues

We use GitHub Issues to organize all significant work. Any external contributions will first take the form of issues.

Existing issues

Briefly review all open issues for the following reasons:

  • Search for contribution opportunities
  • Verify that your contribution idea is not already in progress

Create an issue (~5 min)

To create a new issue, use the following two (2) templates:

All contributions that are not bug fixes must be pre-approved by the maintainers.

Close an issue

At any time, you can close issues that you create yourself.


Authoring code

Follow these steps when you are ready to begin writing code:

  1. Fork the repository.
  2. Modify your fork using the CLI or GitHub flow.
  3. When your fork contains your finished and tested code, create a pull request.

Exception for minor bug fixes

For single-line bug fixes, you can optionally edit the file directly on the Github website without needing to create a fork.

Best practices for coding

  1. Follow coding best practices such as DRY and SOLID where possible.
  2. Carefully read the pull request template and follow it closely.
  3. Don't include AWS account identifiers or secret keys in your examples.

Disclaimers

Review the following important disclaimers before contributing to this project.

Conduct disclaimer

This project abides by the Amazon Open Source Code of Conduct. For additional help, contact opensource-codeofconduct@amazon.com.

Security disclaimer

If you discover a potential security issue, please notify AWS Security via our vulnerability reporting page. Please do not create a public issue on GitHub.

Licensing disclaimer

See the LICENSE file for this project's licensing.


Questions

To request help or clarification on this CONTRIBUTING.md, add a comment in your issue and we will reply within 5 business days.