diff --git a/.github/contributing.md b/.github/contributing.md new file mode 100644 index 00000000..81b38ecb --- /dev/null +++ b/.github/contributing.md @@ -0,0 +1,25 @@ +## Submitting issues + +If you have questions about how to install or use Nextcloud, please direct these to our [forum][forum]. We are also available on [IRC][irc]. + +### Short version + + * The [**issue template can be found here**][template]. 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) +* This repository ([Monitoring](https://github.com/nextcloud/serverinfo/issues)) is *only* for issues within the Monitoring code. +* __SECURITY__: Report any potential security bug to us via [our HackerOne page](https://hackerone.com/nextcloud) or security@nextcloud.com following our [security policy](https://nextcloud.com/security/) instead of filing an issue in our bug tracker +* Report the issue using our [template][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. + +[template]: https://raw.github.com/nextcloud/serverinfo/master/.github/issue_template.md +[forum]: https://help.nextcloud.com/ +[irc]: https://webchat.freenode.net/?channels=nextcloud + +### Contribute Code and translations +Please check [server's contribution guidelines](https://github.com/nextcloud/server/blob/master/CONTRIBUTING.md#contributing-to-source-code) for further information about contributing code and translations. diff --git a/.github/issue_template.md b/.github/issue_template.md new file mode 100644 index 00000000..675af79d --- /dev/null +++ b/.github/issue_template.md @@ -0,0 +1,77 @@ + +### Steps to reproduce +1. +2. +3. + +### Expected behaviour +Tell us what should happen + +### Actual behaviour +Tell us what happens instead + +### Server configuration + + +**Operating system**: + +**Web server:** + +**Database:** + +**PHP version:** + +**Nextcloud version:** (see Nextcloud admin page) + +**Where did you install Nextcloud from:** + + +**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 Nextcloud installation folder +``` + +**Nextcloud configuration:** + +``` +If you have access to your command line run e.g.: +sudo -u www-data php occ config:list system +from within your Nextcloud installation folder + +or + +Insert your config.php content here +Make sure to remove all sensitive content such as passwords. (e.g. database password, passwordsalt, secret, smtp password, …) +``` + +### Client configuration +**Browser:** + +**Operating system:** + +### Logs + +#### Nextcloud log (data/owncloud.log) +``` +Insert your Nextcloud log here +``` + +#### Browser log +``` +Insert your browser log here, this could for example include: + +a) The javascript console log +b) The network log +c) ... +```