From 2eb94066112a605f641f979c040fcfc9b710ac76 Mon Sep 17 00:00:00 2001 From: Daniel Molkentin Date: Mon, 14 Jan 2013 12:33:21 +0100 Subject: [PATCH] add CONTRIBUTING.md and reporting template for mirall --- CONTRIBUTING.md | 48 +++++++++++++++++++++++++++++++++++++++++++++++ issue_template.md | 48 +++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 96 insertions(+) create mode 100644 CONTRIBUTING.md create mode 100644 issue_template.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 000000000..6d5002132 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,48 @@ +## Submitting Desktop Client issues + +If you have questions about how to use the ownCloud Desktop Client, please +direct these to the [mailing list][mailinglist] or our [forum][forum]. +We are also available on [IRC][irc]. + +### Guidelines +* Report the issue using our [template][template], it includes all the + informations we need to track down the issue. This repository is *only* for +* issues within the ownCloud core code. Issues in other compontents should be + reported in their own repositores: + - [Android client](https://github.com/owncloud/android/issues) + - [iOS client](https://github.com/owncloud/ios-issues/issues) + - [Desktop client](https://github.com/owncloud/mirall/issues) + - [ownCloud apps](https://github.com/owncloud/apps/issues) (e.g. Calendar, + Contacts...) +* Search the existing issues first, it's likely that your issue was already + reported. + +If your issue appears to be a bug, and hasn't been reported, open a new issue. + +Help us to maximize the effort we can spend fixing issues and adding new +features, by not reporting duplicate issues. + +[template]: https://raw.github.com/owncloud/mirall/master/issue_template.md +[mailinglist]: https://mail.kde.org/mailman/listinfo/owncloud +[forum]: http://forum.owncloud.org/ +[irc]: http://webchat.freenode.net/?channels=owncloud&uio=d4 + +## Contributing to Source Code + +Thanks for wanting to contribute source code to ownCloud. That's great! + +Before we're able to merge your code to mirall, you need to sign +our [Contributor Agreement][agreement]. + +Please read the [Desktop Client Manual][mirallman] and the [Developer +Manuals][devmanual] to get useful infos like how to create your first +application or how to test the ownCloud code with phpunit. + +[agreement]: http://owncloud.org/about/contributor-agreement/ +[devmanual]: http://owncloud.org/dev/ +[mirallman]: http://doc.owncloud.org/desktop/1.1/ + +## Translations +Please submit translations via [Transifex][transifex]. + +[transifex]: https://www.transifex.com/projects/p/owncloud/ diff --git a/issue_template.md b/issue_template.md new file mode 100644 index 000000000..396c20e4e --- /dev/null +++ b/issue_template.md @@ -0,0 +1,48 @@ +### Expected behaviour +Tell us what should happen + +### Actual behaviour +Tell us what happens instead + +### Steps to reproduce +1. +2. +3. + +### Server configuration +Operating system: + +Web server: + +Database: + +PHP version: + +ownCloud version: + +### Client configuration +Client version: + +Operating system: + +OS language: + +Installation path of client: + +### Logs + +#### output of `owncloud --logwindow` or `owncloud --logfile log.txt` +``` +Insert your log output here +``` + +#### Web server error log +``` +Insert your webserver log here +``` + +#### ownCloud log (data/owncloud.log) +``` +Insert your ownCloud log here +``` +