Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/nextcloud/mail.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChristoph Wurst <christoph@winzerhof-wurst.at>2016-07-27 17:20:30 +0300
committerChristoph Wurst <christoph@winzerhof-wurst.at>2016-07-27 17:20:30 +0300
commit292904fd47daf3e63941623a7aaf42bce76336d4 (patch)
tree6f32e149f88d10cdb7ca5b3f8051e9091770a9ed /.github
parent6b63f50765a5eed84870b5e7e2a86be154a46605 (diff)
move GitHub specifi files to .github and add issue details sections
Diffstat (limited to '.github')
-rw-r--r--.github/CONTRIBUTING.md47
-rw-r--r--.github/issue_template.md106
2 files changed, 153 insertions, 0 deletions
diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
new file mode 100644
index 000000000..e90f3346f
--- /dev/null
+++ b/.github/CONTRIBUTING.md
@@ -0,0 +1,47 @@
+## Submitting issues
+
+If you have questions about how to install or use ownCloud, please direct these to the [mailing list][mailinglist] or our [forum][forum]. We are also available on [IRC][irc].
+
+### Short version
+
+ * The [**issue template can be found here**][template] but be aware of the different repositories! See 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](https://help.github.com/articles/searching-issues)
+* 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 mail code. Issues in other compontents should be reported in their own repositores:
+ - [ownCloud core](https://github.com/owncloud/core)
+ - [Activity](https://github.com/owncloud/activity/issues)
+ - [Bookmarks](https://github.com/owncloud/bookmarks/issues)
+ - [Calendar](https://github.com/owncloud/calendar/issues)
+ - [Contacts](https://github.com/owncloud/contacts/issues)
+ - [Documents](https://github.com/owncloud/documents/issues)
+ - [Gallery](https://github.com/owncloud/gallery/issues)
+ - [Music](https://github.com/owncloud/music/issues)
+ - [News](https://github.com/owncloud/news/issues)
+ - [Notes](https://github.com/owncloud/notes/issues)
+ - [Tasks](https://github.com/owncloud/tasks/issues)
+ - [All other apps](https://github.com/owncloud/apps/issues)
+
+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/mail/master/issue_template.md
+[mailinglist]: https://mail.kde.org/mailman/listinfo/owncloud
+[forum]: http://forum.owncloud.org/
+[irc]: https://webchat.freenode.net/?channels=owncloud-mail
+
+## Contributing to Source Code
+
+Thanks for wanting to contribute source code to ownCloud Mail. That's great!
+
+[devmanual]: http://owncloud.org/dev/
+
+## Translations
+Please submit translations via [Transifex][transifex].
+
+[transifex]: https://www.transifex.com/projects/p/owncloud/
diff --git a/.github/issue_template.md b/.github/issue_template.md
new file mode 100644
index 000000000..79ea0d5e5
--- /dev/null
+++ b/.github/issue_template.md
@@ -0,0 +1,106 @@
+### Steps to reproduce
+1.
+2.
+3.
+
+### Expected behaviour
+Tell us what should happen
+
+### Actual behaviour
+Tell us what happens instead
+
+### ownCloud Mail
+
+**ownCloud Mail version:** (see ownCloud apps admin page)
+
+**Mailserver or service:** (e.g. Outlook, Yahoo, Gmail, Exchange,...)
+
+**Transport security - IMAP:** (None, SSL, TLS, STARTTLS)
+
+**Transport security - SMTP:** (None, SSL, TLS, STARTTLS)
+
+**Number of accounts:**
+
+**ownCloud Mail version build date:** (only if you are using a Nightly Build)
+
+
+### ownCloud Core
+
+#### Server configuration
+**Operating system**:
+
+**Web server:**
+
+**Database:**
+
+**PHP version:**
+
+**ownCloud version:** (see ownCloud admin page)
+
+**Updated from an older ownCloud or fresh install:**
+
+**List of activated apps:**
+
+```
+If you have access to your command line run e.g.:
+sudo -u www-data php occ app:list
+from within your ownCloud installation folder
+```
+
+**The content of config/config.php:**
+
+<details>
+```
+If you have access to your command line run e.g.:
+sudo -u www-data php occ config:list system
+from within your ownCloud installation folder
+
+or
+
+Insert your config.php content here
+(Without the database password, passwordsalt and secret)
+```
+</details>
+
+#### Client configuration
+**Browser:**
+
+**Operating system:**
+
+#### Logs
+##### Web server error log
+```
+Insert your webserver log here
+```
+
+##### ownCloud log (data/owncloud.log)
+<details>
+```
+Insert your ownCloud log here
+```
+</details>
+
+##### Horde IMAP log (data/horde_imap.log)
+<details>
+```
+Insert your horde IMAP log here, see https://github.com/owncloud/mail#debug-mode
+```
+</details>
+
+##### Horde SMTP log (data/horde_smtp.log)
+<details>
+```
+Insert your horde SMTP log here, see https://github.com/owncloud/mail#debug-mode
+```
+</details>
+
+##### Browser log
+<details>
+```
+Insert your browser log here, this could for example include:
+
+a) The javascript console log
+b) The network log
+c) ...
+```
+</details>