Skip to content

Commit 71f07c7

Browse files
merblanblumhardt
authored andcommitted
Code of Conduct, Contributing Guide & templates for issues and PRs (#24)
* Added issue and PR templates along with contrib and code of conduct pages. * Link fix. * Update PULL_REQUEST_TEMPLATE.md
1 parent 63f0a95 commit 71f07c7

File tree

5 files changed

+99
-0
lines changed

5 files changed

+99
-0
lines changed

.github/ISSUE_TEMPLATE.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
**A few questions before you begin:**
2+
3+
> Is this an issue related to the Serilog core project or one of the [sinks](https://github.com/serilog/serilog/wiki/Provided-Sinks) or [community projects](https://github.com/serilog/serilog/wiki/Community-Projects). This issue list is intended for Serilog core issues. If this issue relates to a sink or related project, please log on the related repository. Please use [Gitter chat](https://gitter.im/serilog/serilog) and [Stack Overflow](http://stackoverflow.com/questions/tagged/serilog) for discussions and questons.
4+
5+
6+
**Does this issue relate to a new *feature* or an existing *bug*?**
7+
- [ ] Bug
8+
- [ ] New Feature
9+
10+
**What version of Serilog Console Sink is affected by this issue? Please list the related NuGet package.**
11+
12+
**What is the target framework and operating system affected by this issue? Please see [target frameworks](https://docs.microsoft.com/en-us/nuget/schema/target-frameworks) & [net standard matrix](https://docs.microsoft.com/en-us/dotnet/standard/net-standard).**
13+
14+
- [ ] netCore 2.0
15+
- [ ] netCore 1.0
16+
- [ ] 4.7
17+
- [ ] 4.6.x
18+
- [ ] 4.5.x
19+
20+
**Please describe the current behaviour you are experiencing?**
21+
22+
**Please describe the expected behaviour if the ?**
23+
24+
**If the current behavior is a bug, please provide the steps to reproduce the issue and if possible a minimal demo of the problem**
25+
*NOTE: A small code sample goes a long way in expediting bug fixes or illustrating an enhancement you are proposing.*

.github/PULL_REQUEST_TEMPLATE.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
**What issue does this PR address?**
2+
*Please list any GitHub issues here*
3+
4+
**Does this PR introduce a breaking change?**
5+
*Please list any changes that may cause issues for users, including binary breaking changes*
6+
7+
**Please check if the PR fulfills these requirements**
8+
- [ ] The commit follows our [guidelines](https://github.com/serilog/serilog-sinks-console/blob/dev/CONTRIBUTING.md)
9+
- [ ] Unit Tests for the changes have been added (for bug fixes / features)
10+
11+
**Other information**:
12+
*Please list any other relevant information here*

CODE_OF_CONDUCT.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# Code of Conduct
2+
3+
Please refer to the [Serilog Code of Conduct](https://github.com/serilog/serilog/blob/dev/CONTRIBUTING.md) which covers all repositories within the Serilog Organisation.

CONTRIBUTING.md

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
# Contributing to the Serilog Console Sink
2+
3+
First of all thanks for dropping by, feel free to checkout [Serilog core project's contributing page](https://github.com/serilog/serilog/blob/dev/CONTRIBUTING.md) which contains some key points about the organisation.
4+
5+
## Reporting an issue
6+
7+
Bugs are tracked via [GitHub][issue_list] issues. Below are some notes to help create a new issue. The issue template will help you on the way.
8+
9+
* Create an issue via the [issues list][create_issue].
10+
* List the version of Serilog that is affected
11+
* List the target framework and operating system
12+
* If possible, provide a sample that reproduces the issue.
13+
14+
## Requesting a feature/enhancement
15+
16+
Feature as also tracked via [GitHub][issue_list] issues. Below are some notes to help create an issue. The issue template will help you on the way
17+
18+
* Create an issue via the [issues list][create_issue].
19+
* List the version of Serilog that is affected
20+
* List the target framework and operating system
21+
* If possible, provide a sample that reproduces the issue.
22+
23+
## Making a PR
24+
25+
* If an issue does not already exist please create one via the issues list.
26+
* Fork the repository and create a branch with a descriptive name.
27+
* Attempt to make commits of logical units.
28+
* When committing, please reference the issue the commit relates to.
29+
* Run the build and tests.
30+
* Windows platforms can use the `build.ps1` script. (This is the script used in AppVeyor builds)
31+
* nix/OSX platforms can use the `build.sh` script. (This is the script used in Travis builds)
32+
* Create the PR, the PR template will help provide a stub of what information is required including:
33+
* The issue this PR addresses
34+
* Unit Tests for the changes have been added.
35+
36+
## Questions?
37+
38+
Serilog has an active and helpful community who are happy to help point you in the right direction or work through any issues you might encounter. You can get in touch via:
39+
40+
* [Stack Overflow](http://stackoverflow.com/questions/tagged/serilog) - this is the best place to start if you have a question
41+
* Our [issue tracker](https://github.com/serilog/serilog/issues) here on GitHub
42+
* [Gitter chat](https://gitter.im/serilog/serilog)
43+
* The [#serilog tag on Twitter](https://twitter.com/search?q=%23serilog)
44+
45+
Finally when contributing please keep in mind our [Code of Conduct][serilog_code_of_conduct].
46+
47+
[serilog]: https://github.com/serilog/serilog
48+
[sinks]: https://github.com/serilog/serilog/wiki/Provided-Sinks
49+
[community_projects]: https://github.com/serilog/serilog/wiki/Community-Projects
50+
[create_issue]: https://github.com/serilog/serilog-sinks-console/issues/new
51+
[issue_list]: https://github.com/serilog/serilog-sinks-console/issues/
52+
[serilog_code_of_conduct]: https://github.com/serilog/serilog/blob/dev/CODE_OF_CONDUCT.md

README.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -143,6 +143,13 @@ To achieve output identical to version 2 of this sink, specify a formatter and o
143143

144144
This will bypass theming and use Serilog's built-in message template formatting.
145145

146+
### Contributing
147+
148+
Would you like to help make the Serilog console sink even better? We keep a list of issues that are approachable for newcomers under the [up-for-grabs](https://github.com/serilog/serilog-sinks-console/issues?labels=up-for-grabs&state=open) label. Before starting work on a pull request, we suggest commenting on, or raising, an issue on the issue tracker so that we can help and coordinate efforts. For more details check out our [contributing guide](CONTRIBUTING.md).
149+
150+
When contributing please keep in mind our [Code of Conduct](CODE_OF_CONDUCT.md).
151+
152+
146153
### Detailed build status
147154

148155
Branch | AppVeyor | Travis

0 commit comments

Comments
 (0)