Skip to content

Commit 17c3074

Browse files
committed
docs(templates): add github templates for issues and pull requests
1 parent 34cfa7c commit 17c3074

6 files changed

+160
-19
lines changed

.github/CODE_OF_CONDUCT.md

+46
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# Contributor Covenant Code of Conduct
2+
3+
## Our Pledge
4+
5+
In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and 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 identity and orientation.
6+
7+
## Our Standards
8+
9+
Examples of behavior that contributes to creating a positive environment include:
10+
11+
- Using welcoming and inclusive language
12+
- Being respectful of differing viewpoints and experiences
13+
- Gracefully accepting constructive criticism
14+
- Focusing on what is best for the community
15+
- Showing empathy towards other community members
16+
17+
Examples of unacceptable behavior by participants include:
18+
19+
- The use of sexualized language or imagery and unwelcome sexual attention or advances
20+
- Trolling, insulting/derogatory comments, and personal or political attacks
21+
- Public or private harassment
22+
- Publishing others' private information, such as a physical or electronic address, without explicit permission
23+
- Other conduct which could reasonably be considered inappropriate in a professional setting
24+
25+
## Our Responsibilities
26+
27+
Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
28+
29+
Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
30+
31+
## Scope
32+
33+
This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
34+
35+
## Enforcement
36+
37+
Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at [email protected]. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
38+
39+
Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
40+
41+
## Attribution
42+
43+
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
44+
45+
[homepage]: http://contributor-covenant.org
46+
[version]: http://contributor-covenant.org/version/1/4/

.github/ISSUE_TEMPLATE.md

+43
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
<!--- Provide a general summary of the issue in the Title above -->
2+
3+
<!--- Remember to follow CONTRIBUTING.md guidelines otherwise your issue will be closed -->
4+
5+
## Expected Behavior
6+
7+
<!--- If you're describing a bug, tell us what should happen -->
8+
<!--- If you're suggesting a change/improvement, tell us how it should work -->
9+
10+
## Current Behavior
11+
12+
<!--- If describing a bug, tell us what happens instead of the expected behavior -->
13+
<!--- If suggesting a change/improvement, explain the difference from current behavior -->
14+
15+
## Affected features
16+
17+
- [ ] node API
18+
- [ ] cli
19+
20+
## Possible Solution
21+
22+
<!--- Not obligatory, but suggest a fix/reason for the bug, -->
23+
<!--- or ideas how to implement the addition or change -->
24+
25+
## Steps to Reproduce (for bugs)
26+
27+
<!--- Provide a link to a live example, or an unambiguous set of steps to -->
28+
<!--- reproduce this bug. Include code to reproduce, if relevant -->
29+
30+
1. 2. 3. 4.
31+
32+
## Context
33+
34+
<!--- How has this issue affected you? What are you trying to accomplish? -->
35+
<!--- Providing context helps us come up with a solution that is most useful in the real world -->
36+
37+
## Your Environment
38+
39+
<!--- Include as many relevant details about the environment you experienced the bug in -->
40+
41+
- OS:
42+
- node-wifi version
43+
- wifi card:

.github/PULL_REQUEST_TEMPLATE.md

+28
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
<!--- Provide a general summary of your changes in the Title above -->
2+
3+
<!--- Remember to follow CONTRIBUTING.md guidelines otherwise your pull request will be refused -->
4+
5+
## Description
6+
7+
<!--- Describe your changes in detail -->
8+
9+
## Motivation and Context
10+
11+
<!--- Why is this change required? What problem does it solve? -->
12+
<!--- If it fixes an open issue, please link to the issue here. -->
13+
14+
## Usage examples
15+
16+
<!--- Provide examples of intended usage -->
17+
18+
## How Has This Been Tested?
19+
20+
<!--- Please describe in detail how you tested your changes. -->
21+
22+
## Types of changes
23+
24+
<!--- What types of changes does your code introduce? Put an `x` in all the boxes that apply: -->
25+
26+
- [ ] Bug fix (non-breaking change which fixes an issue)
27+
- [ ] New feature (non-breaking change which adds functionality)
28+
- [ ] Breaking change (fix or feature that would cause existing functionality to change)

BIBLIOGRAPHY.md

+1
Original file line numberDiff line numberDiff line change
@@ -4,3 +4,4 @@ Curated list of useful documentation for this project:
44

55
- [The-way-to-fully-automated-releases-in-open-source-projects](https://medium.com/@kevinkreuzer/the-way-to-fully-automated-releases-in-open-source-projects-44c015f38fd6)
66
- [Travis tutorial](https://docs.travis-ci.com/user/tutorial/)
7+
- [Example for github templates](https://github.com/conventional-changelog/commitlint/blob/master/.github)

CONTRIBUTING.md

+37-15
Original file line numberDiff line numberDiff line change
@@ -2,25 +2,49 @@
22

33
:+1::tada: First off, thanks for taking the time to contribute! :tada::+1:
44

5-
The following is a set of guidelines for contributing to node-wifi.
5+
## Found an Issue?
66

7-
1. Fork `node-wifi` repository
8-
2. Post an issue to propose your feature/improvement. It will be very useful to know if your idea has a chance to be accepted
9-
3. Implement your feature
10-
4. Test your feature
11-
5. Squash your commits into one
12-
6. Write your commit message following [conventional commits specification](https://www.conventionalcommits.org/en/v1.0.0-beta.3/)
13-
7. Create pull request for dev branch
7+
Thank you for reporting any issues you find. We do our best to test and make node-wifi as solid as possible, but any reported issue is a real help.
148

15-
> :information_source: Version 3 will be released soon and will provide a (lot of changes)[https://github.com/friedrith/node-wifi/projects/1]. Don't worry, everything will be retrocompatible. But it is every important to create an issue before proposing a pull request to integrate the fix
16-
> directly in the version 2 release.
9+
Please follow these guidelines when reporting issues:
1710

18-
And please try to consider your development for windows, linux and macOS platforms at the same time
19-
because having a module compatible with all platforms is the main concern of `node-wifi`.
11+
- Provide a title in the format of `<Error> when <Task>`
12+
- Tag your issue with the tag `bug`
13+
- Provide a short summary of what you are trying to do
14+
- Provide the log of the encountered error if applicable
15+
- Provide the exact version of node-wifi.
16+
- Be awesome and consider contributing a [pull request](#want-to-contribute)
17+
18+
## Want to contribute?
19+
20+
You consider contributing changes to node-wifi – we dig that!
21+
Please consider these guidelines when filing a pull request:
22+
23+
- Follow the [Commit Rules](#commit-rules)
24+
- Make sure you rebased the current master branch when filing the pull request
25+
- Squash your commits when filing the pull request
26+
- Provide a short title with a maximum of 100 characters
27+
- Provide a more detailed description containing
28+
_ What you want to achieve
29+
_ What you changed
30+
_ What you added
31+
_ What you removed
32+
- For significant changes, post also an issue before to know if your idea has a chance to be accepted
33+
- Consider your development for windows, linux and macOS platforms at the same time
34+
because having a module compatible with all platforms is the main concern of `node-wifi`.
2035

2136
**May the force be with you !!**
2237

23-
## Conventional commits
38+
## Commit Rules
39+
40+
To help everyone with understanding the commit history of commitlint the following commit rules are enforced.
41+
42+
- [conventional commits](https://www.conventionalcommits.org/en/v1.0.0-beta.3/)
43+
- husky commit message hook available
44+
- present tense
45+
- maximum of 100 characters
46+
- for bugs, includes the github tag of the issue in the description.
47+
- message format of `$type($scope): $message`
2448

2549
These are the authorized types:
2650

@@ -35,5 +59,3 @@ These are the authorized types:
3559
- revert
3660
- style
3761
- test
38-
39-
And please include the reference to the issue or the pull request in the description.

README.md

+5-4
Original file line numberDiff line numberDiff line change
@@ -165,11 +165,12 @@ Please read [development guidelines](./CONTRIBUTING.md) before proposing a pull
165165
## Roadmap
166166

167167
- [x] add conventional commits
168-
- [ ] plug to travis
169-
- [ ] add github templates
168+
- [x] plug to travis
169+
- [x] add github templates
170+
- [ ] add eslint
171+
- [ ] add prettier
170172
- [ ] switch to MIT license
171173
- [ ] install commitizen
172174
- [ ] rewrite the library using ES7
173175
- [ ] add unit tests
174-
- [ ] add eslint
175-
- [ ] add prettier
176+
- [ ] stdout how to reproduce bug

0 commit comments

Comments
 (0)