Merge pull request #1515 from ldez/github-template-again
doc: enhance Github templates.
This commit is contained in:
commit
eefcf026d2
5 changed files with 45 additions and 47 deletions
19
.github/ISSUE_TEMPLATE.md
vendored
19
.github/ISSUE_TEMPLATE.md
vendored
|
@ -1,9 +1,22 @@
|
||||||
<!--
|
<!--
|
||||||
How to write a good issue?
|
PLEASE READ THIS MESSAGE.
|
||||||
|
|
||||||
Read https://github.com/containous/traefik/blob/master/.github/how-to-write-a-good-issue.md
|
Please keep in mind that the GitHub issue tracker is not intended as a general support forum, but for reporting bugs and feature requests.
|
||||||
|
|
||||||
|
For other type of questions, consider using one of:
|
||||||
|
|
||||||
|
- the Traefik community Slack channel: https://traefik.herokuapp.com
|
||||||
|
- StackOverflow: https://stackoverflow.com/questions/tagged/traefik
|
||||||
|
|
||||||
|
HOW TO WRITE A GOOD ISSUE?
|
||||||
|
|
||||||
|
- if it's possible use the command `traefik bug`. See https://www.youtube.com/watch?v=Lyz62L8m93I.
|
||||||
|
- The title must be short and descriptive.
|
||||||
|
- Explain the conditions which led you to write this issue: the context.
|
||||||
|
- The context should lead to something, an idea or a problem that you’re facing.
|
||||||
|
- Remain clear and concise.
|
||||||
|
- Format your messages to help the reader focus on what matters and understand the structure of your message, use Markdown syntax https://help.github.com/articles/github-flavored-markdown
|
||||||
|
|
||||||
And the contributing guide: https://github.com/containous/traefik/blob/master/.github/CONTRIBUTING.md
|
|
||||||
-->
|
-->
|
||||||
|
|
||||||
### Do you want to request a *feature* or report a *bug*?
|
### Do you want to request a *feature* or report a *bug*?
|
||||||
|
|
16
.github/PULL_REQUEST_TEMPLATE.md
vendored
16
.github/PULL_REQUEST_TEMPLATE.md
vendored
|
@ -1,9 +1,19 @@
|
||||||
<!--
|
<!--
|
||||||
How to write a good pull request?
|
PLEASE READ THIS MESSAGE.
|
||||||
|
|
||||||
Read https://github.com/containous/traefik/blob/master/.github/how-to-write-a-good-pull-request.md.
|
HOW TO WRITE A GOOD PULL REQUEST?
|
||||||
|
|
||||||
|
- Make it small.
|
||||||
|
- Do only one thing.
|
||||||
|
- Avoid re-formatting.
|
||||||
|
- Make sure the code builds.
|
||||||
|
- Make sure all tests pass.
|
||||||
|
- Add tests.
|
||||||
|
- Write useful descriptions and titles.
|
||||||
|
- Address review comments in terms of additional commits.
|
||||||
|
- Do not amend/squash existing ones unless the PR is trivial.
|
||||||
|
- Read the contributing guide: https://github.com/containous/traefik/blob/master/.github/CONTRIBUTING.md.
|
||||||
|
|
||||||
And the contributing guide: https://github.com/containous/traefik/blob/master/.github/CONTRIBUTING.md.
|
|
||||||
-->
|
-->
|
||||||
|
|
||||||
### Description
|
### Description
|
||||||
|
|
25
.github/how-to-write-a-good-issue.md
vendored
25
.github/how-to-write-a-good-issue.md
vendored
|
@ -1,25 +0,0 @@
|
||||||
# How to write a good issue
|
|
||||||
|
|
||||||
Please keep in mind that the GitHub issue tracker is not intended as a general support forum, but for reporting bugs and feature requests.
|
|
||||||
|
|
||||||
For other type of questions, consider using one of:
|
|
||||||
|
|
||||||
- the [Traefik community Slack channel](https://traefik.herokuapp.com)
|
|
||||||
- [StackOverflow](https://stackoverflow.com/questions/tagged/traefik)
|
|
||||||
|
|
||||||
## Title
|
|
||||||
|
|
||||||
The title must be short and descriptive.
|
|
||||||
|
|
||||||
## Description of the issue
|
|
||||||
|
|
||||||
- Explain the conditions which led you to write this issue: the context.
|
|
||||||
- The context should lead to something, an idea or a problem that you’re facing.
|
|
||||||
- Remain clear and concise.
|
|
||||||
|
|
||||||
## Format your messages
|
|
||||||
|
|
||||||
Help the reader focus on what matters and understand the structure of your message.
|
|
||||||
[GitHub flavored markdown](https://help.github.com/articles/github-flavored-markdown) has a simple but effective syntax: make use of bold text, lists, check-boxes, syntax highlighting, headers, lists, links and images.
|
|
||||||
|
|
||||||
|
|
13
.github/how-to-write-a-good-pull-request.md
vendored
13
.github/how-to-write-a-good-pull-request.md
vendored
|
@ -1,13 +0,0 @@
|
||||||
# How to write a good pull request
|
|
||||||
|
|
||||||
- Make it small
|
|
||||||
- Do only one thing
|
|
||||||
- Avoid re-formatting
|
|
||||||
- Make sure the code builds
|
|
||||||
- Make sure all tests pass
|
|
||||||
- Add tests
|
|
||||||
- Write useful descriptions and titles
|
|
||||||
- Address review comments in terms of additional commits.
|
|
||||||
- Do not amend/squash existing ones unless the PR is trivial.
|
|
||||||
|
|
||||||
Read [10 tips for better pull requests](http://blog.ploeh.dk/2015/01/15/10-tips-for-better-pull-requests/).
|
|
|
@ -17,11 +17,24 @@ import (
|
||||||
var (
|
var (
|
||||||
bugtracker = "https://github.com/containous/traefik/issues/new"
|
bugtracker = "https://github.com/containous/traefik/issues/new"
|
||||||
bugTemplate = `<!--
|
bugTemplate = `<!--
|
||||||
How to write a good issue?
|
PLEASE READ THIS MESSAGE.
|
||||||
|
|
||||||
Read https://github.com/containous/traefik/blob/master/.github/how-to-write-a-good-issue.md
|
Please keep in mind that the GitHub issue tracker is not intended as a general support forum, but for reporting bugs and feature requests.
|
||||||
|
|
||||||
|
For other type of questions, consider using one of:
|
||||||
|
|
||||||
|
- the Traefik community Slack channel: https://traefik.herokuapp.com
|
||||||
|
- StackOverflow: https://stackoverflow.com/questions/tagged/traefik
|
||||||
|
|
||||||
|
HOW TO WRITE A GOOD ISSUE?
|
||||||
|
|
||||||
|
- if it's possible use the command` + "`" + `traefik bug` + "`" + `. See https://www.youtube.com/watch?v=Lyz62L8m93I.
|
||||||
|
- The title must be short and descriptive.
|
||||||
|
- Explain the conditions which led you to write this issue: the context.
|
||||||
|
- The context should lead to something, an idea or a problem that you’re facing.
|
||||||
|
- Remain clear and concise.
|
||||||
|
- Format your messages to help the reader focus on what matters and understand the structure of your message, use Markdown syntax https://help.github.com/articles/github-flavored-markdown
|
||||||
|
|
||||||
And the contributing guide: https://github.com/containous/traefik/blob/master/.github/CONTRIBUTING.md
|
|
||||||
-->
|
-->
|
||||||
|
|
||||||
### Do you want to request a *feature* or report a *bug*?
|
### Do you want to request a *feature* or report a *bug*?
|
||||||
|
|
Loading…
Reference in a new issue