-
Notifications
You must be signed in to change notification settings - Fork 1
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
DO-1486: Include CODE_OF_CONDUCT.md and CONTRIBUTING.md files #1056
Merged
Merged
Changes from 1 commit
Commits
Show all changes
3 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,63 @@ | ||
# Code of Conduct | ||
|
||
We are committed to providing a welcoming and inclusive environment for everyone who participates in this project, regardless of gender, | ||
gender identity and expression, sexual orientation, disability, physical appearance, body size, race, ethnicity, age, religion, or any other personal characteristic. | ||
|
||
## Our Responsibilities | ||
|
||
As project maintainers, we are responsible for maintaining a respectful and inclusive environment. We will take appropriate and fair action in response to any reports of unacceptable behavior, | ||
harassment, discrimination, or other violations of this code of conduct. | ||
|
||
We are committed to: | ||
- Ensuring that the project remains a safe and inclusive space for all contributors. | ||
- Addressing any reported issues promptly and with discretion. | ||
- Providing guidance and support to those who experience harassment, discrimination, or other violations of this code of conduct. | ||
- Taking appropriate measures to prevent further occurrences of unacceptable behavior. | ||
|
||
## Expected Behavior | ||
|
||
We expect all contributors to adhere to the following code of conduct: | ||
|
||
1. __Be respectful and inclusive:__ Respect the opinions and ideas of others. Treat all individuals with kindness, empathy, and courtesy. Use inclusive language and avoid any form of discrimination or harassment. | ||
2. __Maintain a safe environment:__ Create an environment where everyone feels safe and comfortable to express their ideas, ask questions, and share their work. Do not engage in any behavior that can be perceived as threatening, offensive, or harmful. | ||
3. __Collaborate and communicate effectively:__ Foster a collaborative and constructive atmosphere. Be open to feedback and be willing to collaborate with others. Strive for clear and effective communication, both in discussions and in written form. | ||
4. __Appreciate diverse perspectives:__ Recognize and appreciate the value of diverse perspectives and experiences. Embrace different ideas, approaches, and backgrounds. Be open-minded and considerate of others' opinions. | ||
5. __Resolve conflicts peacefully:__ In the event of conflicts or disagreements, resolve them peacefully and respectfully. If necessary, seek mediation or assistance from project maintainers to help find a resolution. | ||
6. __Follow the project guidelines:__ Adhere to the guidelines and procedures set forth by the project. Respect the project's technical choices, coding conventions, and contribution guidelines. | ||
7. __Report any issues:__ If you encounter any behavior that violates this code of conduct or have any concerns, please report it to the project maintainers. They will address the issue promptly and confidentially. | ||
|
||
|
||
|
||
## Unacceptable Behavior | ||
|
||
Unacceptable behavior includes, but is not limited to: | ||
- Harassment, discrimination, or offensive behavior based on personal characteristics. | ||
- Intimidation, threats, or any other form of inappropriate conduct. | ||
- Exclusion or marginalization of individuals or groups. | ||
- Sharing or displaying explicit or offensive material unrelated to the project's purpose. | ||
- Any other behavior deemed inappropriate for a professional or community setting. | ||
|
||
## Consequences of Unacceptable Behavior | ||
|
||
Instances of unacceptable behavior will not be tolerated. Those engaging in such behavior may face consequences, including: | ||
- A private or public warning from the project maintainers. | ||
- Temporary or permanent restrictions on participation in community spaces. | ||
- Removal of contributions. | ||
- Reporting to relevant authorities, as necessary. | ||
|
||
## Reporting Guidelines | ||
|
||
If you believe you have experienced or witnessed any form of unacceptable behavior, harassment, discrimination, or other violations of the code of conduct, please follow these guidelines: | ||
- If you feel comfortable, address your concerns directly with the person(s) involved, aiming for a respectful resolution. | ||
- If the issue persists, or you prefer not to engage directly, please contact the project maintainers privately. Rest assured, your report will be handled with utmost confidentiality. | ||
- Provide detailed information, including any supporting evidence, to aid in the investigation and resolution of the matter. | ||
- We will respect requests for confidentiality, particularly when it comes to protecting victims of abuse or harassment. However, complete confidentiality may limit our ability to address the situation effectively. | ||
|
||
## Attribution | ||
|
||
This code of conduct is adapted from the Contributor Covenant, version 2.0, available at https://www.contributor-covenant.org/version/2/0/code_of_conduct.html. | ||
|
||
__By participating in this project, you are expected to uphold this code of conduct. Project maintainers have the right and responsibility to remove, edit, | ||
or reject any contributions that do not align with this code of conduct.__ | ||
|
||
Thank you for helping create a positive and inclusive community! |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,168 @@ | ||
# Contributing to Aligent's CDK Constructs | ||
|
||
🙌 Welcome to the Aligent CDK Constructs repository! 🙌 | ||
|
||
We appreciate your interest in contributing to this project. Please take a moment to review the guidelines below to ensure a smooth and collaborative contribution process. | ||
|
||
By participating in this project, you are expected to adhere to the [Code of Conduct]. | ||
We strive to maintain a welcoming and inclusive environment for all contributors. | ||
|
||
_These guidelines are intended to provide direction, but they are not meant to be rigid rules. We trust your judgment | ||
and invite you to propose any changes to this document by submitting a pull request. Your feedback is valuable, | ||
and we welcome collaborative improvements to these guidelines._ | ||
|
||
## Table of Contents | ||
- [Overview](#overview) | ||
- [How Can I Contribute?](#how-can-i-contribute) | ||
- [Getting Started](#getting-started) | ||
- [Forking the Repository](#forking-the-repository) | ||
- [Setting Up the Development Environment](#setting-up-the-development-environment) | ||
- [Making Changes](#making-changes) | ||
- [Branching Strategy](#branching-strategy) | ||
- [Commit Guidelines](#commit-guidelines) | ||
- [Pull Request Guidelines](#pull-request-guidelines) | ||
- [Updating Documentation](#updating-documentation) | ||
- [Creating a Release](#creating-a-release) | ||
- [Release Tag Format](#release-tag-format) | ||
|
||
## Code of Conduct | ||
|
||
We are committed to providing a welcoming and inclusive environment for everyone who participates in this project. | ||
Please review our [Code of Conduct] to understand the expectations and guidelines for behavior within the community. | ||
|
||
## Overview | ||
This repository contains Aligent's [AWS CDK Constructs]. | ||
|
||
Below is a list of available constructs: | ||
|
||
- [basic-auth](packages/basic-auth) | ||
- [cloudfront-security-headers](packages/cloudfront-security-headers) | ||
- [geoip-redirect](packages/geoip-redirect) | ||
- [prerender-proxy](packages/prerender-proxy) | ||
- [rabbitmq](packages/rabbitmq) | ||
- [shared-vpc](packages/shared-vpc) | ||
- [static-hosting](packages/static-hosting) | ||
- [waf](packages/waf) | ||
|
||
## How Can I Contribute? | ||
|
||
We welcome contributions from the community, and there are several ways you can contribute to this project: | ||
- __Reporting Issues:__ If you encounter any bugs, errors, or have suggestions for improvements, please [open an issue] on GitHub. Provide as much detail as possible to help us understand and address the problem. | ||
- __Submitting Pull Requests:__ If you have implemented a new feature, fixed a bug, or made any other improvements to the project, we encourage you to submit a pull request. Please follow the guidelines in the [Making Changes](#making-changes) section below when creating your pull request. | ||
- __Improving Documentation:__ Documentation is essential for the project's usability and understanding. If you find any areas that can be improved or have suggestions for new documentation, feel free to contribute by submitting a pull request. | ||
- __Sharing Feedback:__ Your feedback and ideas are valuable to us. If you have suggestions, questions, or feedback regarding the project, please share them with us by opening an issue or participating in discussions on existing issues. | ||
|
||
## Getting Started | ||
|
||
### Forking the Repository | ||
|
||
To contribute to this project, you should start by forking the repository to your GitHub account. This will create a copy of the repository under your account, which you can freely modify. | ||
|
||
### Setting Up the Development Environment | ||
|
||
Before making any changes, ensure that you have the necessary development environment set up. Follow the steps below: | ||
|
||
1. Clone the forked repository to your local machine. | ||
```sh | ||
git clone https://github.com/your-username/cdk-constructs.git | ||
``` | ||
2. Install the required dependencies. | ||
```sh | ||
cd cdk-constructs | ||
npm ci | ||
``` | ||
Now you're ready to start making changes! | ||
|
||
## Making Changes | ||
|
||
### Branching Strategy | ||
|
||
When working on a new feature or bug fix, it is recommended to create a new branch to isolate your changes. Follow these steps: | ||
|
||
1. Create a new branch based on the main branch. | ||
```sh | ||
git checkout -b feature/my-feature | ||
``` | ||
2. Make your desired changes in the codebase. | ||
3. Commit your changes with a descriptive message. | ||
```sh | ||
git commit -m "Add feature: my new feature" | ||
``` | ||
4. Push your branch to your forked repository. | ||
```sh | ||
git push origin feature/my-feature | ||
``` | ||
5. Open a pull request (PR) on the original repository to propose your changes. | ||
|
||
## Commit Guidelines | ||
|
||
When making commits, please adhere to the following guidelines: | ||
- Use the present tense ("Add feature" not "Added feature") | ||
- Use clear and concise commit messages | ||
- Reference any relevant issues or pull requests in your commit message using the appropriate keywords (Fixes #issue-number, Resolves #pull-request-number, etc.) | ||
- Limit the first line to 72 characters or less | ||
- Make sure each commit represents a logical unit of work | ||
|
||
## Pull Request Guidelines | ||
|
||
To ensure a smooth review process and increase the chances of your pull request being merged, please follow these guidelines: | ||
1. Ensure that your pull request addresses an existing issue or feature request. If none exists, consider opening one to discuss your proposed changes before submitting the pull request. | ||
2. Provide a clear and descriptive title for your pull request. | ||
3. Include a detailed description of the changes you have made. Explain the purpose and benefits of your changes. | ||
4. Ensure that your code adheres to the project's coding conventions and style guidelines. | ||
5. Include any necessary documentation updates to reflect your changes. | ||
6. Test your changes thoroughly to avoid introducing new bugs. | ||
7. Keep your pull request focused and limited to a single logical change. If you have multiple unrelated changes, consider submitting separate pull requests. | ||
8. Be responsive to any feedback or requests for changes during the review process. Engage in constructive discussions to address any concerns raised by the reviewers. | ||
9. Once your pull request has been approved, it will be merged by the project maintainers. | ||
|
||
Thank you for your valuable contributions! 🎉 | ||
|
||
## Updating Documentation | ||
|
||
Keeping the documentation up-to-date is essential for maintaining the project's usability and ensuring that users have the necessary information. | ||
If you make changes to the codebase, please consider updating the relevant documentation, including the README files. | ||
|
||
Make sure the documentation accurately reflects the changes you have made and provides clear instructions or explanations for users. Also, | ||
check for any outdated information and remove or update it accordingly. | ||
|
||
### Updating README Files | ||
|
||
For each package/construct within the monorepo, it is important to update the corresponding README.md file to reflect any changes, additions, or removals. | ||
Ensure that the README provides clear and concise information about the package/construct, its purpose, usage, and any necessary instructions or examples. | ||
|
||
Make sure to include the following information in the README: | ||
- Description of the package/construct and its functionality. | ||
- Installation instructions, including any dependencies. | ||
- Usage examples and code snippets to help users understand how to use the package/construct. | ||
- Configuration options or settings, if applicable. | ||
- Contribution guidelines, including how others can contribute to the package/construct. | ||
- Any other relevant information or resources that would assist users. | ||
|
||
Your efforts in updating and improving the documentation are highly appreciated. | ||
|
||
## Creating a Release | ||
|
||
The following section outlines the release process for maintainers. | ||
|
||
Each construct or package in this monorepo has an independent release cycle. Once the changes have been approved and merged into the main branch, you can create a release. | ||
|
||
**Note that for all the finalized releases, the source branch should be the main branch.** | ||
|
||
If the release is experimental, you may use the `main` or the feature branch. | ||
|
||
For example: | ||
- Experimental release: `basic-auth-1.1.0-beta` | ||
- Finalized release: `basic-auth-1.1.0` | ||
|
||
## Note for Maintainers | ||
|
||
The release process outlined above is primarily applicable to maintainers of this repository. As a maintainer, it is your responsibility to review and merge pull requests, | ||
create releases, and manage the versioning of the constructs. | ||
|
||
Additionally, as a maintainer, please ensure that the README files for each construct are kept up-to-date. When introducing changes or new features, | ||
update the corresponding README to reflect those changes accurately. This will help users understand the functionality and usage of each construct. | ||
|
||
[Code of Conduct]: ./CODE_OF_CONDUCT.md | ||
[open an issue]: https://github.com/aligent/cdk-constructs/issues | ||
[AWS CDK Constructs]: https://docs.aws.amazon.com/cdk/v2/guide/constructs.html |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should this just link to the README rather than listing the constructs? I can see myself forgetting to update this 😅