Skip to content

Latest commit

 

History

History
57 lines (41 loc) · 1.99 KB

CONTRIBUTING.md

File metadata and controls

57 lines (41 loc) · 1.99 KB
Raw

Contributing to BOSH vSphere-CPI

When contributing a pull request, be sure to submit your pull request against the master branch.

Contributor License Agreement

Follow these steps to make a contribution to any of CF open source repositories:

  1. Ensure that you have completed our CLA Agreement for individuals or corporations.

  2. Set your name and email (these should match the information on your submitted CLA)

git config --global user.name "Firstname Lastname"
git config --global user.email "your_email@example.com"
  1. See development docs to start contributing to BOSH vSphere-CPI.

Creating a Local Development Release Tarball

  1. Run bosh create-release --tarball ~/<PATH>/bosh-vsphere-cpi-release-XX.tgz --force.

Commit messages

Please follow the rules of writing good Git commit messages:

  • Separate subject from body with a blank line
  • Limit the subject line to 50 characters
  • Capitalize the subject line
  • Do not end the subject line with a period
  • Use the imperative mood in the subject line
  • Wrap the body at 72 characters
  • Use the body to explain what and why vs. how

In addition to those rules, we also like to include references to external resources, such as Pivotal Tracker stories and GitHub issues. For example, at the bottom of your commit messages:

[GH: Fixes #123, Related: #432, #111]
[finishes #159212203](https://www.pivotaltracker.com/story/show/159212203)

Also, if you're pairing or working with more people on your commit, we encourage you to use the Co-authored-by line in order to attribute credit to everyone that contributed. For example (yes you can have as many of those as you want):

Co-authored-by: Steven Kumar <sk@cloudfoundry.org>
Co-authored-by: Ravi Jones <rj@cloudfoundry.org>