CONTRIBUTING.md

Submitting issues

If you have questions about how to install or use ownCloud, please direct these to our forum. For getting in touch with the developers, join our public Matrix channel.

Short version

• Submit your issue to our issue tracker, but be aware of the different repositories. See the list below. Please always use the issue template when reporting issues.

Guidelines

• Please search the existing issues first, it's likely that your issue was already reported or even fixed.
  • Go to one of the repositories, click "issues" and type any word in the top search/command bar.
  • You can also filter by appending e.g. "state:open" to the search string.
  • More info on search syntax within github
• SECURITY: Report any potential security bug to us via our HackerOne page or security@owncloud.com following our security policy instead of filing an issue in our bug tracker
• This repository (web) is only for issues within the Web code.
• The issues in other components should be reported in their respective repositories:
  • ownCloud Classic
  • ownCloud Infinite Scale
  • Android client
  • iOS client
  • Desktop client
  • Documentation
  • ownCloud apps
• Submit your issue to our issue tracker. Please stick to our issue template, it includes all the information we need to track down the issue.

Help us to maximize the effort we can spend fixing issues and adding new features, by not reporting duplicate issues.

Contributing to Source Code

Thanks for wanting to contribute source code to ownCloud. That's great!

Before we're able to merge your code, you need to sign our Contributor Agreement. You can sign it digitally as soon as you open your first pull request.

Please read the Developer Documentation to learn how to use our extension system or how to run tests for your features.

In order to constantly increase the quality of our software we can no longer accept pull requests which submit un-tested code. We have the goal that code segments are unit tested. Please try to help us with that goal. In some areas unit testing is hard (aka almost impossible) as of today - in these areas refactoring WHILE fixing a bug is encouraged to enable unit testing.

Translations

Please submit translations via Transifex.