File: contributing.md

package info (click to toggle)
python-httplib2 0.22.0-1
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 1,448 kB
  • sloc: python: 6,629; javascript: 3,563; makefile: 56
file content (26 lines) | stat: -rw-r--r-- 1,214 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# Welcome

You have come to the right place if you want to support httplib2 by doing. Thank you!

- [Reporting security / sensitive issues](SECURITY.md)
- [Regular issues](https://github.com/httplib2/httplib2/issues?q=) please try to find existing solution first, search without issue/open filters.
- If you intend to propose code change, there is no need to open an issue first. Pull request is more than enough. `git diff` in message is fine too.
- Tests use TLS certificates/keys generated by `script/generate-tls`


## Submitting changes (pull request policy)

- Run `pre-commit install` once to setup hooks that detect/fix common style issues and run unit tests. [pre-commit website](https://pre-commit.com/)
- If you don't want pre-commit hooks, please run `script/test` before commit
- Test is required, or at least coverage must not decrease
- One commit is strongly preferred, except for very big changes
- Feel free to append yourself into __contributors__
- Commit message should follow the following formula:

>subsystem: description of why the change is useful
>
>optional details
>
>links to related issues or websites

The why part is very important. Diff already says what is changed. Explain why.