Skip to content
This repository was archived by the owner on Jun 1, 2025. It is now read-only.

Commit c2eaf11

Browse files
Merge pull request #22 from Dog-Face-Development/willtheorangeguy-community-docs
Add community documentation
2 parents 877f6e3 + 52eda9a commit c2eaf11

File tree

7 files changed

+674
-26
lines changed

7 files changed

+674
-26
lines changed

CHANGELOG.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# Changelog
2+
3+
## [v0.1.0](https://github.com/Dog-Face-Development/DFD-Code-Style-Guide/releases/tag/v0.1.0)
4+
5+
### Added
6+
7+
- Workflows and legal documentation.

CODE_OF_CONDUCT.md

Lines changed: 121 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,121 @@
1+
# Contributor Covenant Code of Conduct
2+
3+
## Our Pledge
4+
5+
We as members, contributors, and leaders pledge to make participation in our
6+
community a harassment-free experience for everyone, regardless of age, body
7+
size, visible or invisible disability, ethnicity, sex characteristics, gender
8+
identity and expression, level of experience, education, socio-economic status,
9+
nationality, personal appearance, race, religion, or sexual identity
10+
and orientation.
11+
12+
We pledge to act and interact in ways that contribute to an open, welcoming,
13+
diverse, inclusive, and healthy community.
14+
15+
## Our Standards
16+
17+
Examples of behavior that contributes to a positive environment for our
18+
community include:
19+
20+
* Demonstrating empathy and kindness toward other people
21+
* Being respectful of differing opinions, viewpoints, and experiences
22+
* Giving and gracefully accepting constructive feedback
23+
* Accepting responsibility and apologizing to those affected by our mistakes,
24+
and learning from the experience
25+
* Focusing on what is best not just for us as individuals, but for the
26+
overall community
27+
28+
Examples of unacceptable behavior include:
29+
30+
* The use of sexualized language or imagery, and sexual attention or
31+
advances of any kind
32+
* Trolling, insulting or derogatory comments, and personal or political attacks
33+
* Public or private harassment
34+
* Publishing others' private information, such as a physical or email
35+
address, without their explicit permission
36+
* Other conduct which could reasonably be considered inappropriate in a
37+
professional setting
38+
39+
## Enforcement Responsibilities
40+
41+
Community leaders are responsible for clarifying and enforcing our standards of
42+
acceptable behavior and will take appropriate and fair corrective action in
43+
response to any behavior that they deem inappropriate, threatening, offensive,
44+
or harmful.
45+
46+
Community leaders have the right and responsibility to remove, edit, or reject
47+
comments, commits, code, wiki edits, issues, and other contributions that are
48+
not aligned to this Code of Conduct, and will communicate reasons for moderation
49+
decisions when appropriate.
50+
51+
## Scope
52+
53+
This Code of Conduct applies within all community spaces, and also applies when
54+
an individual is officially representing the community in public spaces.
55+
Examples of representing our community include using an official e-mail address,
56+
posting via an official social media account, or acting as an appointed
57+
representative at an online or offline event.
58+
59+
## Enforcement
60+
61+
Instances of abusive, harassing, or otherwise unacceptable behavior may be
62+
reported to the community leaders responsible for enforcement at the project's
63+
[Discord](https://discord.gg/73azSgcNYt).
64+
All complaints will be reviewed and investigated promptly and fairly.
65+
66+
All community leaders are obligated to respect the privacy and security of the
67+
reporter of any incident.
68+
69+
## Enforcement Guidelines
70+
71+
Community leaders will follow these Community Impact Guidelines in determining
72+
the consequences for any action they deem in violation of this Code of Conduct:
73+
74+
### 1. Correction
75+
76+
**Community Impact**: Use of inappropriate language or other behavior deemed
77+
unprofessional or unwelcome in the community.
78+
79+
**Consequence**: A private, written warning from community leaders, providing
80+
clarity around the nature of the violation and an explanation of why the
81+
behavior was inappropriate. A public apology may be requested.
82+
83+
### 2. Warning
84+
85+
**Community Impact**: A violation through a single incident or series
86+
of actions.
87+
88+
**Consequence**: A warning with consequences for continued behavior. No
89+
interaction with the people involved, including unsolicited interaction with
90+
those enforcing the Code of Conduct, for a specified period of time. This
91+
includes avoiding interactions in community spaces as well as external channels
92+
like social media. Violating these terms may lead to a temporary or
93+
permanent ban.
94+
95+
### 3. Temporary Ban
96+
97+
**Community Impact**: A serious violation of community standards, including
98+
sustained inappropriate behavior.
99+
100+
**Consequence**: A temporary ban from any sort of interaction or public
101+
communication with the community for a specified period of time. No public or
102+
private interaction with the people involved, including unsolicited interaction
103+
with those enforcing the Code of Conduct, is allowed during this period.
104+
Violating these terms may lead to a permanent ban.
105+
106+
### 4. Permanent Ban
107+
108+
**Community Impact**: Demonstrating a pattern of violation of community
109+
standards, including sustained inappropriate behavior, harassment of an
110+
individual, or aggression toward or disparagement of classes of individuals.
111+
112+
**Consequence**: A permanent ban from any sort of public interaction within
113+
the community.
114+
115+
## Attribution
116+
117+
This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org),
118+
version 2.0.
119+
120+
Community Impact Guidelines were inspired by [Mozilla's code of conduct
121+
enforcement ladder](https://github.com/mozilla/diversity).

CONTRIBUTING.md

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
# Contributing to the Dog Face Development Co. Code Style Guide
2+
3+
🎉 Thanks for taking the time to contribute! 🎉
4+
5+
The following is a set of guidelines for contributing to Dog Face Development Co.'s Code Style Guide project on GitHub. These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.
6+
7+
## Code of Conduct
8+
9+
This project and everyone participating in it is governed by the [Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. Please report unacceptable behavior to our [Discord](https://discord.gg/73azSgcNYt).
10+
11+
## Signing the CLA
12+
13+
If you are not an employee of Dog Face Development Co. and want to submit a pull request to our open source project, you must first sign a Contributor License Agreement (CLA). This allows you to retain your ownership of the code submitted while granting Dog Face Development the necessary legal rights to use your contribution. The CLA only needs to be signed once and it covers all our projects. Follow these simple steps to sign:
14+
15+
- If you are creating a pull request on your own, read the [Individual CLA](https://github.com/Dog-Face-Development/DFD-Code-Style-Guide/blob/v0.1.0/docs/legal/CLA_INDIVIDUAL.md). If you are creating a pull request as part of your employment, read the [Entity CLA](https://github.com/Dog-Face-Development/DFD-Code-Style-Guide/blob/v0.1.0/docs/legal/CLA_ENTITY.md).
16+
- Open a [pull request](https://github.com/Dog-Face-Development/DFD-Code-Style-Guide/compare).
17+
- The CLA Assistant bot will ask you to sign the pull request by writing the following text: `I have read the CLA Document, and I hereby sign the CLA.` If you agree to the CLA, copy the text.
18+
- The CLA Assistant bot will mark your pull request as CLA approved, and you won't have to sign the CLA again!
19+
20+
## New Contributor Guide
21+
22+
To get an overview of the project, read the [README](README.md). Here are some resources to help you get started with open source contributions:
23+
24+
- [Finding ways to contribute to open source on GitHub](https://docs.github.com/en/get-started/exploring-projects-on-github/finding-ways-to-contribute-to-open-source-on-github).
25+
- [Set up Git](https://docs.github.com/en/get-started/quickstart/set-up-git).
26+
- [GitHub flow](https://docs.github.com/en/get-started/quickstart/github-flow).
27+
- [Collaborating with pull requests](https://docs.github.com/en/github/collaborating-with-pull-requests).
28+
29+
Please contribute using [GitHub Flow](https://guides.github.com/introduction/flow). Create a branch, add commits, and [open a pull request](https://github.com/Dog-Face-Development/DFD-Code-Style-Guide/compare).
30+
31+
## How to Contribute
32+
33+
### Did you find a bug?
34+
35+
- **Ensure the bug was not already reported** by searching on GitHub under [Issues](https://github.com/Dog-Face-Development/DFD-Code-Style-Guide/issues).
36+
- If you're unable to find an open issue addressing the problem, [open a new one](https://github.com/Dog-Face-Development/DFD-Code-Style-Guide/issues/new/choose). Be sure to include a **title and clear description**, as much relevant information as possible, and a **code sample** or an **executable test case** demonstrating the expected behavior that is not occurring.
37+
- Use the issue templates to create the issue. They include step by step guidelines and have lists of things that should be included.
38+
39+
### Did you write a patch that fixes a bug or updates the documentation?
40+
41+
- Open a new [Pull Request](https://github.com/Dog-Face-Development/DFD-Code-Style-Guide/compare) on GitHub with the patch.
42+
- Ensure the pull request description clearly describes the problem and solution. Be sure to include a **title**, and as much relevant information as possible. Include the relevant issue number if applicable.
43+
44+
### Did you fix whitespace, format code, or make a purely cosmetic patch?
45+
46+
- Changes that are cosmetic in nature and do not add anything substantial to the stability, functionality, or testability of the Style Guides are still accepted! Just follow the same instructions as above.
47+
- However, do ensure that any cosmetic changes follow the Dog Face Development Co. Style Guides, found [below](#style).
48+
49+
### Do you intend to add a new feature or change an existing one?
50+
51+
- **Ensure the feature was not already introduced** by searching on GitHub under [Issues](https://github.com/Dog-Face-Development/DFD-Code-Style-Guide/issues). Look for those under the [enhancement](https://github.com/Dog-Face-Development/DFD-Code-Style-Guide/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement) tag.
52+
- If you're unable to find an open issue addressing the new feature, [open a new one](https://github.com/Dog-Face-Development/DFD-Code-Style-Guide/issues/new/choose)!
53+
54+
### Do you have questions about the source code?
55+
56+
- Ask any question about how to use the Style Guides on our [Discord](https://discord.gg/73azSgcNYt).
57+
- If it does not get answered, open an [issue](https://github.com/Dog-Face-Development/DFD-Code-Style-Guide/issues/new/choose).
58+
59+
## Coding Conventions
60+
61+
Start reading our code and you'll get the hang of it.
62+
63+
- A CLA must be signed before contributing (see [above](#signing-the-cla)).
64+
- We indent using four spaces (NOT tabs).
65+
- Every function or piece of code should be heavily commented.
66+
- We use [Semantic Versioning](https://semver.org/).
67+
68+
## Style
69+
70+
While contributing to a Dog Face Development Co. project, make sure your code follow our [Code Style Guide](https://github.com/Dog-Face-Development/DFD-Code-Style-Guide), and any web design elements follow our [Web Style Guide](https://github.com/Dog-Face-Development/DFD-Web-Style-Guide). If you have any changes you wish to make to the styling of our code or web projects, open an issue or pull request on the respective style guide!
71+
72+
## Attribution
73+
74+
This document is adapted from the Contributing documents of [Rails](https://github.com/rails/rails/blob/main/CONTRIBUTING.md), the [GitHub Docs](https://github.com/github/docs/blob/main/CONTRIBUTING.md), [Atom](https://github.com/atom/atom/blob/master/CONTRIBUTING.md), and [OpenGovernment](https://github.com/opengovernment/opengovernment/blob/master/CONTRIBUTING.md?plain=1).

0 commit comments

Comments
 (0)