Skip to content

Commit 854c7a3

Browse files
committed
chore: added community standard documents
1 parent 5b1bef1 commit 854c7a3

File tree

7 files changed

+208
-0
lines changed

7 files changed

+208
-0
lines changed

.github/CODE_OF_CONDUCT.md

+48
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# Code of Conduct
2+
3+
## Introduction
4+
5+
This document outlines the code of conduct for contributors, maintainers, and users of the "commitlint" project. It aims to foster an inclusive and respectful community, promoting collaboration and positive interactions. By participating in this project, you are expected to adhere to this code of conduct. This code of conduct applies to all project-related spaces, including GitHub repositories, issue trackers, mailing lists, and social media platforms associated with the project.
6+
7+
## Our Pledge
8+
9+
In the interest of fostering an open and welcoming environment, we, as contributors, maintainers, and users of the commitlint project, pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual orientation.
10+
11+
## Expected Behavior
12+
13+
To create a positive and inclusive environment, we expect all participants to:
14+
15+
1. Be respectful and considerate: Treat others with kindness, respect, and empathy, fostering a welcoming and collaborative atmosphere.
16+
2. Be inclusive and supportive: Welcome individuals from all backgrounds, experiences, and perspectives, ensuring everyone feels valued and heard.
17+
3. Be mindful of language and tone: Use inclusive language and avoid offensive or derogatory comments or personal attacks.
18+
4. Be constructive: Provide constructive feedback, suggestions, and criticism in a respectful manner, with the aim of improving the project and fostering growth.
19+
5. Be open-minded: Embrace diverse ideas, viewpoints, and approaches, encouraging healthy discussions and debates.
20+
6. Be accountable: Take responsibility for your actions, acknowledge and learn from mistakes, and avoid repeating harmful behavior.
21+
7. Respect project guidelines: Adhere to the project's technical guidelines, contribution guidelines, and licensing requirements.
22+
23+
## Unacceptable Behavior
24+
25+
The following behaviors are considered unacceptable and will not be tolerated within the community:
26+
27+
1. Harassment and discrimination: Engaging in any form of harassment, discrimination, or exclusionary behavior, including but not limited to offensive comments, slurs, insults, derogatory remarks, or personal attacks.
28+
2. Intimidation and threats: Intimidating or threatening behavior, both online and offline, towards any participant in the community.
29+
3. Unwelcome advances: Making unwelcome sexual advances, inappropriate comments, or any other behavior of a sexual nature.
30+
4. Spam and trolling: Posting irrelevant, repetitive, or disruptive content with the intention of annoying or provoking others.
31+
5. Violation of privacy: Sharing personal or confidential information of others without their explicit consent.
32+
6. Plagiarism and intellectual property infringement: Claiming the work of others as your own, including copying code or content without proper attribution or permission.
33+
7. Violation of project guidelines: Repeatedly disregarding the project's technical guidelines, contribution guidelines, or licensing requirements.
34+
35+
## Reporting and Enforcement
36+
37+
Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project maintainers at [email protected] or [email protected]. All complaints will be reviewed and investigated promptly and fairly. The project maintainers are responsible for maintaining the confidentiality of the reporting individual(s).
38+
39+
In the case of a verified violation of this code of conduct, appropriate actions will be taken, which may include:
40+
41+
1. Educating the individual(s) involved about the code of conduct and providing guidance on acceptable behavior.
42+
2. Issuing warnings or temporary bans from project-related spaces.
43+
3. Implementing permanent bans from project-related spaces for repeated or severe violations.
44+
4. Reporting illegal behavior to relevant authorities if necessary.
45+
46+
## Attribution
47+
48+
This code of conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/version/2/0/code_of_conduct.html) and [Mozilla Community Participation Guidelines](https://www.mozilla.org/en-US/about/governance/policies/participation/). It is licensed under the Creative Commons Attribution 4.0 International License

.github/ISSUE_TEMPLATE/bug_report.md

+32
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
name: Bug report
3+
about: Create a report to help us improve.
4+
title: ''
5+
labels: bug, help wanted
6+
assignees: aj3sh, sugat009
7+
---
8+
9+
**Describe the bug**
10+
A clear and concise description of what the bug is.
11+
12+
**To Reproduce**
13+
Please provide the steps to reproduce the issue. Include code snippets or specific examples if applicable.
14+
15+
**Expected behavior**
16+
Please provide a clear and concise description of your expected outcome.
17+
18+
**Environment**
19+
20+
- Python version:
21+
- Package version:
22+
- Operating system:
23+
- Any other relevant information about your environment.
24+
25+
**Additional context**
26+
Please provide any additional context or information that may be helpful in understanding and resolving the issue. This can include:
27+
28+
- Error stack trace
29+
- Error messages
30+
- Log files
31+
- Screenshots
32+
- Any other relevant details related to the issue.
+22
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
name: Feature request
3+
about: Suggest an idea for this project
4+
title: ''
5+
labels: ''
6+
assignees: ''
7+
---
8+
9+
**Use Case**
10+
Please describe the specific use case or scenario where this feature would be beneficial.
11+
12+
**Proposed Solution**
13+
Please outline your proposed solution or approach for implementing this feature. Include any relevant details, such as code snippets or examples, if applicable.
14+
15+
**Alternative Considered**
16+
Have you considered any alternative solutions or approaches? If so, please describe them and explain why you believe the proposed solution is the best option.
17+
18+
**Dependencies**
19+
If this feature has any dependencies or requirements, please list them here.
20+
21+
**Additional context**
22+
Add any other context or screenshots about the feature request here.

.github/PULL_REQUEST_TEMPLATE.md

+32
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
## Description
2+
3+
[Provide a brief description of the changes introduced by the pull request.]
4+
5+
## Related Issue
6+
7+
[If your pull request is related to an existing issue, reference it here using the format "Fixes #issue_number".]
8+
9+
## Type of Change
10+
11+
Please mark the appropriate option below to describe the type of change your pull request introduces:
12+
13+
- [ ] Bug fix
14+
- [ ] New feature
15+
- [ ] Enhancement
16+
- [ ] Documentation update
17+
- [ ] Refactor
18+
- [ ] Other (please specify)
19+
20+
## Checklist
21+
22+
- [ ] My pull request has a clear title and description.
23+
- [ ] I have used [semantic commit messages](https://seesparkbox.com/foundry/semantic_commit_messages).
24+
Examples: `"fix: Fixed foobar bug"`, `"feat(accounts): Added foobar feature"`.
25+
- [ ] I have added/updated the necessary documentation on `README.md`.
26+
- [ ] I have added appropriate test cases (if applicable) to ensure the changes are functioning correctly.
27+
28+
## Additional Notes
29+
30+
[Add any additional notes or context that you think the reviewers should know about.]
31+
32+
By submitting this pull request, I confirm that I have read and complied with the contribution guidelines of this project.

.github/SECURITY.md

+51
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# Security Policy
2+
3+
The 'commitlint' project is committed to maintaining the security and integrity of our software. This Security Policy outlines the steps we take to address security vulnerabilities, as well as the responsibilities of our contributors and users in reporting and resolving security-related issues.
4+
5+
## Supported Versions
6+
7+
We provide security updates and support for the latest stable release of the 'commitlint' package. It is important to keep your software up to date to ensure you have the latest security patches.
8+
9+
| Version | Supported |
10+
| ------- | ------------------ |
11+
| 0.1.0 | :white_check_mark: |
12+
13+
## Reporting a Vulnerability
14+
15+
If you discover a security vulnerability within the project, we encourage you to report it the maintainers immediately. Promptly reporting security issues helps us protect our users and take appropriate actions to address the vulnerability. To report a security vulnerability, please follow these steps:
16+
17+
1. Email at [email protected] or [email protected] with a detailed description of the vulnerability. Please include the following information:
18+
19+
- Description of the vulnerability, including steps to reproduce if applicable
20+
- Version of the commitlint package affected
21+
- Any potential mitigations or workarounds
22+
23+
2. Our security team will acknowledge your report within 3 to 7 days and provide further instructions and communication regarding the vulnerability.
24+
25+
3. We kindly request that you do not publicly disclose the vulnerability until we have had sufficient time to address it and provide a fix. We strive to resolve security vulnerabilities promptly and will work with you to coordinate disclosure if necessary.
26+
27+
4. Once the vulnerability is confirmed and addressed, we will release a security update in the form of a new package version. We will credit the reporter if desired.
28+
29+
## Security Updates and Mitigations
30+
31+
Upon receiving a security vulnerability report, our team will evaluate the issue and take appropriate actions to address it. This may include:
32+
33+
- Developing and testing a patch or fix for the vulnerability
34+
- Coordinating with the reporter or other relevant parties to verify the vulnerability and its impact
35+
- Releasing a new version that includes the necessary security fixes
36+
37+
We strive to provide security updates in a timely manner and communicate any necessary steps for users to upgrade to the latest secure version.
38+
39+
## Responsible Disclosure
40+
41+
We are committed to responsible disclosure of security vulnerabilities. Once a vulnerability has been addressed and a new package version is released, we encourage users and contributors to upgrade to the latest version to ensure they are protected.
42+
43+
While we appreciate the efforts of security researchers and users who report vulnerabilities, we kindly request that you follow responsible disclosure practices by allowing us sufficient time to address the issue and release a fix before disclosing the vulnerability publicly.
44+
45+
## Disclaimer
46+
47+
The commitlint project is provided "as is," without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement. In no event shall the package maintainers or contributors be liable for any claim, damages, or other liability arising from the use of the this commitlint project or any security-related incidents.
48+
49+
## Contact
50+
51+
For any questions, concerns, or additional information regarding the commitlint project's security policy, please contact us at [email protected] or [email protected].

CHANGELOG.md

+7
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# CHANGELOG
2+
3+
## 0.1.0
4+
5+
- Created commitlint CLI.
6+
- Created pre-commit configuration for `commit-msg` hook.
7+
- Created support for Github Actions.

CONTRIBUTING.md

+16
Original file line numberDiff line numberDiff line change
@@ -25,3 +25,19 @@ Run the tests using the below command:
2525
```bash
2626
pipenv run test
2727
```
28+
29+
## Before submitting
30+
31+
Before submitting your Pull Request, please do the following steps:
32+
33+
1. Add any changes you want.
34+
1. Add tests for the new changes.
35+
1. Edit documentation (`README.md`) if you have changed something significant.
36+
1. Commit your changes using [semantic commit message](https://seesparkbox.com/foundry/semantic_commit_messages).
37+
Examples: `"fix: Fixed foobar bug"`, `"feat(accounts): Added foobar feature on accounts"`.
38+
39+
## Other help
40+
41+
You can contribute by spreading a word about this library.
42+
It would also be a huge contribution to write a short article on how you are using this project.
43+
You can also share your best practices with us.

0 commit comments

Comments
 (0)