Update docs with contributing section (#6128)

This commit is contained in:
Mellina Yonashiro 2020-03-12 16:49:25 -03:00 коммит произвёл GitHub
Родитель d828191f89
Коммит b8b3bae48f
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
1 изменённых файлов: 32 добавлений и 0 удалений

Просмотреть файл

@ -29,3 +29,35 @@ Visit our **readthedocs** page for other setup and configuration at:
<https://treeherder.readthedocs.io> <https://treeherder.readthedocs.io>
File any bugs you may encounter [here](https://bugzilla.mozilla.org/enter_bug.cgi?product=Tree+Management&component=Treeherder). File any bugs you may encounter [here](https://bugzilla.mozilla.org/enter_bug.cgi?product=Tree+Management&component=Treeherder).
#### Contributing
Everyone is welcome to contribute!
If a bug is not assigned to someone, you can request the bug be assigned to you. You should ask the component owner with your request ("Request information" in Bugzilla and mention in Github).
If you do not receive a response within 2-3 days, you can follow up in the **#treeherder** matrix channel.
After adressing the issue, make sure [every test passes](https://treeherder.readthedocs.io/testing.html) before sending a pull request.
We also recommend setting an `upstream` remote that points to the [Mozilla's Github repo](https://github.com/mozilla/treeherder.git), in addition to `origin` that points to your fork. You should then frequently use `git rebase upstream` rather than merging from your fork to keep your branch current. There are less conflicts this way and the git history is cleaner.
##### Sending a Pull Request
We receive contributions from both Bugzilla and Github. We have some specifications to keep track of them:
1. If your bug comes from **[Bugzilla](https://bugzilla.mozilla.org/query.cgi?query_format=advanced&product=Tree+Management&f1=component&o1=substring&v1=Treeherder&resolution=---)**
After addressing the issue, please send a pull request to this repository, with the **Bugzilla's number ID** in the **title**, so that our bot attaches your patch to the corresponding Bugzilla bug.
`"Bug xxxxxx - [title of the bug or brief explanation]"`
For example: "Bug 123456 - Fix scrolling behavior in Perfherder"
2. If your bug comes from **Github**
In the **description** of the pull request, please mention the **issue number**. That can be done by typing #[issue's number].
For example: "This pull request fixes #5135".
Github automatically links both issue and pull request to one another.