Skip to content

Latest commit

 

History

History
33 lines (19 loc) · 2.63 KB

CONTRIBUTING.md

File metadata and controls

33 lines (19 loc) · 2.63 KB
Raw

Introduction

Welcome and thank you for considering contributing to the lpax project.

Following these guidelines will help us effectively manage the contribution process for everyone involved in the contribution process. It communicates that you respect the time of the developers managing and developing this open source project. In return, we will reciprocate that respect by addressing your issue, assessing changes, and helping you finalize your pull requests.

Contributing

We welcome contributions from the open source community. There are many ways to contribute, from writing code samples, improving the documentation, submitting bug reports and feature requests to writing code which can be incorporated into the SDK itself. This section guides you through submitting a contribution to the Pulp.

Reporting bugs

If you think you have found a bug, first make sure you are testing against the latest version of the project as your issue may have already been fixed. Also search all open and closed issues to see if your issue has already been answered. You may also if you are unable to find your issue then please raise an issue using the provided template. Try to provide as much information as possible that will help us reproduce the problem, provide the ticket that you would like to receive if you had to fix the issue.

Submitting changes

If you have a change that you would like to contribute, please find or open an issue about it first as there may be somebody already working on it, or there may be particular issues that you should know about before implementing the change.

  1. Fork the repository to your own GitHub account, this GitHub guide describes how to do this.
  2. Clone the project to your local machine
  3. Make your changes and ensure that all the tests successfully pass.
  4. Update your local repository and rebase your changes on top of the latest master branch. We prefer that your changes are squashed into a single commit.
  5. Push you changes to your fork
  6. Submit a pull request to the main repository

Code review process

Pull requests are reviewed on a regular basis and will give feedback on the corresponding issue in the repo. After feedback has been given it is expected that you respond within two weeks, the pull request may be closed if it does not show any signs of activity. A Circle CI build will run as part of your pull request, at a minimum this needs to be passing before your contribution is accepted.

Getting in touch

The brest way to get in touch is via the issues page.