Skip to content

Commit 100e220

Browse files
committedSep 24, 2024
docs(issue-reporting): Improve issue reporting guidance
Signed-off-by: Andy Scherzinger <info@andy-scherzinger.de>
1 parent 65cb9c0 commit 100e220

File tree

4 files changed

+103
-25
lines changed

4 files changed

+103
-25
lines changed
 

‎.github/ISSUE_TEMPLATE/bug_report.yml

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
name: Bug report
2-
description: Create a report to help us improve
3-
labels: [ "bug" ]
1+
name: "🐛 Bug report: Nextcloud Android Client"
2+
description: "Submit a report and help us improve the Nextcloud Android Client"
3+
labels: ["bug", "0. Needs triage"]
44
body:
55
- type: checkboxes
66
id: before-posting

‎.github/ISSUE_TEMPLATE/config.yml

+11-4
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
1-
blank_issues_enabled: false
1+
# SPDX-FileCopyrightText: 2020 Nextcloud GmbH and Nextcloud contributors
2+
# SPDX-License-Identifier: AGPL-3.0-or-later
23
contact_links:
3-
- name: Community Support and Help
4-
url: https://help.nextcloud.com/
5-
about: For questions and general help
4+
- name: 🚨 Report a security or privacy issue
5+
url: https://hackerone.com/nextcloud
6+
about: Report security and privacy related issues privately to the Nextcloud team, so we can coordinate the fix and release without potentially exposing all Nextcloud servers and users in the meantime.
7+
- name: ❓ Community Support and Help
8+
url: https://help.nextcloud.com/
9+
about: Configuration, webserver/proxy or performance issues and other questions
10+
- name: 💼 Nextcloud Enterprise
11+
url: https://portal.nextcloud.com/
12+
about: If you are a Nextcloud Enterprise customer, or need Professional support, so it can be resolved directly by our dedicated engineers more quickly

‎.github/ISSUE_TEMPLATE/feature_request.md

+37-9
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,48 @@
11
---
2-
name: Feature request
2+
name: 🚀 Feature request
33
about: Suggest an idea for this project
4-
labels: enhancement
5-
4+
labels: enhancement, 0. Needs triage
65
---
76

8-
### Is your feature request related to a problem? Please describe.
7+
<!--
8+
Thanks for reporting issues back to Nextcloud!
9+
10+
Note: This is the **issue tracker of Nextcloud**, please do NOT use this to get answers to your questions or get help for fixing your installation. This is a place to report bugs to developers, after your server has been debugged. You can find help debugging your system on our home user forums: https://help.nextcloud.com or, if you use Nextcloud in a large organization, ask our engineers on https://portal.nextcloud.com. See also https://nextcloud.com/support for support options.
11+
12+
Nextcloud is an open source project backed by Nextcloud GmbH. Most of our volunteers are home users and thus primarily care about issues that affect home users. Our paid engineers prioritize issues of our customers. If you are neither a home user nor a customer, consider paying somebody to fix your issue, do it yourself or become a customer.
13+
14+
Guidelines for submitting issues:
15+
16+
* Please search the existing issues first, it's likely that your issue was already reported or even fixed.
17+
- Go to https://github.com/nextcloud and type any word in the top search/command bar. You probably see something like "We couldn’t find any repositories matching ..." then click "Issues" in the left navigation.
18+
- You can also filter by appending e. g. "state:open" to the search string.
19+
- More info on search syntax within github: https://help.github.com/articles/searching-issues
20+
21+
* This repository https://github.com/nextcloud/server/issues is *only* for issues within the Nextcloud Server code. This also includes the apps: files, encryption, external storage, sharing, deleted files, versions, LDAP, and WebDAV Auth
22+
23+
* SECURITY: Report any potential security bug to us via our HackerOne page (https://hackerone.com/nextcloud) following our security policy (https://nextcloud.com/security/) instead of filing an issue in our bug tracker.
24+
25+
* The issues in other components should be reported in their respective repositories: You will find them in our GitHub Organization (https://github.com/nextcloud/)
26+
-->
27+
28+
29+
<!--- Please keep this note for other contributors -->
30+
31+
### How to use GitHub
32+
33+
* Please use the 👍 [reaction](https://blog.github.com/2016-03-10-add-reactions-to-pull-requests-issues-and-comments/) to show that you are interested into the same feature.
34+
* Please don't comment if you have no relevant information to add. It's just extra noise for everyone subscribed to this issue.
35+
* Subscribe to receive notifications on status change and new comments.
36+
37+
38+
**Is your feature request related to a problem? Please describe.**
939
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
1040

11-
### Describe the solution you'd like
41+
**Describe the solution you'd like**
1242
A clear and concise description of what you want to happen.
1343

14-
### Describe alternatives you've considered
44+
**Describe alternatives you've considered**
1545
A clear and concise description of any alternative solutions or features you've considered.
1646

17-
### Additional context
47+
**Additional context**
1848
Add any other context or screenshots about the feature request here.
19-
20-
**NOTE:** Be super sure to remove sensitive data like passwords, note that everybody can look here! You can use the Issue Template application to prefill some of the required information: https://apps.nextcloud.com/apps/issuetemplate

‎SECURITY.md

+52-9
Original file line numberDiff line numberDiff line change
@@ -4,25 +4,68 @@
44
-->
55
# Security Policy
66

7-
## Supported Versions
7+
# 💡 TLDR: Report issues at [hackerone.com/nextcloud](https://hackerone.com/nextcloud)
8+
9+
# Security Policy
10+
11+
[Security](https://nextcloud.com/security/) is very important to us.
12+
13+
If you believe you have found a security vulnerability that meets our definition of a security
14+
vulnerability, please report is as described below.
15+
16+
## Context
17+
18+
Please review our [threat model and accepted risks](https://nextcloud.com/security/threat-model) to learn what
19+
is currently considered a security vulnerability versus expected behavior. And review what is considered
20+
[in scope or bounty eligible](https://hackerone.com/nextcloud/policy_scopes).
821

9-
Only the latest version is supported. We release every second month a feature release (currently 3.x) and inbetween a bug fix release (3.x.y).
1022

1123
## Reporting a Vulnerability
1224

13-
Security is very important to us. If you have discovered a security issue with Nextcloud,
14-
please read our responsible disclosure guidelines and contact us at [hackerone.com/nextcloud](https://hackerone.com/nextcloud).
25+
**⚠️ Please do _not_ report security vulnerabilities through public GitHub issues.**
26+
27+
If you have discovered a security matter with Nextcloud, please read our
28+
[responsible disclosure guidelines](https://nextcloud.com/security/) and contact us at
29+
[hackerone.com/nextcloud](https://hackerone.com/nextcloud).
30+
1531
Your report should include:
1632

1733
- Product version
1834
- A vulnerability description
1935
- Reproduction steps
36+
- Any other details you think are likely to be important
37+
38+
### What to Expect
2039

21-
A member of the security team will confirm the vulnerability, determine its impact, and develop a fix.
22-
The fix will be applied to the master branch, tested, and packaged in the next bug fix release.
40+
You should receive an initial acknowledgement within 24 hours in most cases.
41+
42+
A member of the security team will confirm the vulnerability, determine its impact, follow-up with any questions,
43+
and coordinate the fix and publication.
44+
45+
The fix will be applied to all applicable and still supported stable branches, tested, and packaged in the next security release.
2346
The vulnerability will be publicly announced after the release. Finally, your name will be added
24-
to the [hall of fame](https://hackerone.com/nextcloud/thanks) as a thank you from the entire Nextcloud community. Note our
25-
[threat model](https://nextcloud.com/security/threat-model) to know what is expected behavior.
47+
to the [hall of fame](https://hackerone.com/nextcloud/thanks) as a thank you from the entire Nextcloud
48+
community.
49+
50+
If the vulnerability involves an app that is not maintained by Nextcloud (i.e. hosted by the
51+
Nextcloud project but community maintained, or hosted elsewhere), the security team will try to coordinate with the
52+
current maintainer and help to get the issue fixed in similar fashion.
53+
54+
### Bug Bounties
55+
56+
If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Details
57+
on past bounty ranges can be found at [hackerone.com/nextcloud](https://hackerone.com/nextcloud).
58+
59+
## Existing Security Advisories
60+
61+
Published security advisories for the Nextcloud Server, Clients and Apps can be viewed at
62+
[https://github.com/nextcloud/security-advisories/security/advisories](https://github.com/nextcloud/security-advisories/security/advisories).
63+
64+
## Supported Versions
65+
66+
Only the latest version is supported. We release every second month a feature release (currently 3.x) and inbetween a bug fix release (3.x.y).
2667

68+
## Additional Information
2769

28-
Please visit https://nextcloud.com/security/ for further information about security.
70+
Please visit [https://nextcloud.com/security/](https://nextcloud.com/security/) for further information about Nextcloud security.
71+
Please visit [https://nextcloud.com/security/threat-model](https://nextcloud.com/security/threat-model) for our threat model and accepted risks.

0 commit comments

Comments
 (0)