1# Contributing
2
31. Sign one of the
4[contributor license agreements](#contributor-license-agreements) below.
51. [Install Go](https://golang.org/doc/install).
61. Clone the repo:
7
8 `git clone https://github.com/googleapis/google-api-go-client`
91. Change into the checked out source:
10
11 `cd google-api-go-client`
121. Fork the repo.
131. Set your fork as a remote:
14
15 `git remote add fork git@github.com:GITHUB_USERNAME/google-api-go-client.git`
161. Make changes (see [Formatting](#formatting) and [Style](#style)), commit to
17 your fork.
18
19 Commit messages should follow the
20 [Conventional Commit specification](https://www.conventionalcommits.org/en/v1.0.0/).
21 For example:
22 ```
23 functions: add gophers codelab
24 ```
251. Send a pull request with your changes.
261. A maintainer will review the pull request and make comments.
27
28 Prefer adding additional commits over ammending and force-pushing since it can
29 be difficult to follow code reviews when the commit history changes.
30
31 Commits will be squashed when they're merged.
32
33## Formatting
34
35All code must be formatted with `gofmt` (with the latest Go version) and pass
36`go vet`.
37
38## Style
39
40Please read and follow https://github.com/golang/go/wiki/CodeReviewComments for
41all Go code in this repo.
42
43## Contributor License Agreements
44
45Before we can accept your pull requests you'll need to sign a Contributor
46License Agreement (CLA):
47
48- **If you are an individual writing original source code** and **you own the
49intellectual property**, then you'll need to sign an [individual CLA][indvcla].
50- **If you work for a company that wants to allow you to contribute your
51work**, then you'll need to sign a [corporate CLA][corpcla].
52
53You can sign these electronically (just scroll to the bottom). After that,
54we'll be able to accept your pull requests.
55
56## Contributor Code of Conduct
57
58As contributors and maintainers of this project,
59and in the interest of fostering an open and welcoming community,
60we pledge to respect all people who contribute through reporting issues,
61posting feature requests, updating documentation,
62submitting pull requests or patches, and other activities.
63
64We are committed to making participation in this project
65a harassment-free experience for everyone,
66regardless of level of experience, gender, gender identity and expression,
67sexual orientation, disability, personal appearance,
68body size, race, ethnicity, age, religion, or nationality.
69
70Examples of unacceptable behavior by participants include:
71
72* The use of sexualized language or imagery
73* Personal attacks
74* Trolling or insulting/derogatory comments
75* Public or private harassment
76* Publishing other's private information,
77such as physical or electronic
78addresses, without explicit permission
79* Other unethical or unprofessional conduct.
80
81Project maintainers have the right and responsibility to remove, edit, or reject
82comments, commits, code, wiki edits, issues, and other contributions
83that are not aligned to this Code of Conduct.
84By adopting this Code of Conduct,
85project maintainers commit themselves to fairly and consistently
86applying these principles to every aspect of managing this project.
87Project maintainers who do not follow or enforce the Code of Conduct
88may be permanently removed from the project team.
89
90This code of conduct applies both within project spaces and in public spaces
91when an individual is representing the project or its community.
92
93Instances of abusive, harassing, or otherwise unacceptable behavior
94may be reported by opening an issue
95or contacting one or more of the project maintainers.
96
97This Code of Conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org), version 1.2.0,
98available at [http://contributor-covenant.org/version/1/2/0/](http://contributor-covenant.org/version/1/2/0/)
99
100[indvcla]: https://developers.google.com/open-source/cla/individual
101[corpcla]: https://developers.google.com/open-source/cla/corporate
View as plain text