Skip to content

Latest commit

 

History

History
72 lines (47 loc) · 4.44 KB

CONTRIBUTING.md

File metadata and controls

72 lines (47 loc) · 4.44 KB
Raw

Contributors Guide

Table of contents

Thank you for your interest in Holy Build Box - a Phusion Passenger supported project. Holy Build Box is open source and welcomes contributions. This guide gives you an overview of the ways with which you can contribute, as well as contribution guidelines.

You can contribute in one of the following areas:

  • Filing bugs.
  • Bug triage.
  • Documentation (user documentation, developer documentation, contributor documentation).
  • Community support.
  • Code.

Please submit patches in the form of a Github pull request.

Filing bug reports

When filing a bug report, please ensure that you include the following information:

  • What steps will reproduce the problem?
  • What is the expected output? What do you see instead?
  • What does your environment looks like (operating system, language, configuration, infrastructure)

For a more detailed guide, please refer to our issue template.

Contributing documentation

Documentation and tutorials can be found in the README for this project.

Contributing by bug triaging

Users file bug reports on a regular basis, but not all bug reports contain sufficient information, persist with new releases, are equally important, etc. By helping with bug triaging you make the lives of the core developers a lot easier.

To start contributing, please submit a comment on any bug report that needs triaging. This comment should contain triaging instructions, e.g. whether a report should be considered duplicate. If you contribute regularly we'll give you moderator access to the bug tracker so that you can apply triaging labels directly.

Here are some of the things that you should look for:

  • Some reports are duplicates of each other, i.e. they report the same issue. You should mark them as duplicate and note the ID of the original report.
  • Some reported problems are caused by the reporter's machine or the reporter's application. You should explain to them what the problem actually is, that it's not caused by Holy Build Box, and then close the report.
  • Some reports need more information. At the very least, we need specific instructions on how to reproduce the problem. You should ask the reporter to provide more information. Some reporters reply slowly or not at all. If some time has passed, you should remind the reporter about the request for more information. But if too much time has passed and the issue cannot be reproduced, you should close the report and mark it as "Stale".
  • Some bug reports seem to be limited to one reporter, and it does not seem that other people suffer from the same problem. These are reports that need confirmation. You can help by trying to reproduce the problem.
  • Some reports are important, but have been neglected for too long. Although the core developers try to minimize the number of times this happens, sometimes it happens anyway because they're so busy. You should actively ping the core developers and remind them about it. Or better: try to actively find contributors who can help solving the issue.

Always be polite to bug reporters. Not all reporters are fluent in English, and not everybody may be tech-savvy. But we ask you for your patience and tolerance. We want to stimulate a positive and enjoyable environment.

Contributing community support

You can contribute by answering support questions on Stack Overflow.

##Contributing code

Holy Build Box is mostly written in Shell and Perl but contains traces of (pun intended) Python as well.

Pull Requests

Pull requests should normally be submitted against the latest stable branch (e.g. master), because once tested & accepted, we want users to benefit from the work as soon as possible.

For more information, please refer to our template for Pull Requests.