Merge pull request #1515 from ldez/github-template-again

doc: enhance Github templates.
This commit is contained in:
Emile Vauge 2017-05-01 16:08:14 +02:00 committed by GitHub
commit eefcf026d2
5 changed files with 45 additions and 47 deletions

View file

@ -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 youre 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*?

View file

@ -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

View file

@ -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 youre 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.

View file

@ -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/).

View file

@ -17,11 +17,24 @@ import (
var (
bugtracker = "https://github.com/containous/traefik/issues/new"
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 youre 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*?