mirror of
https://github.com/nginx/nginx.git
synced 2025-07-20 19:27:29 +08:00
docs: Update community health files
* Update issue templates to issue forms * Add language around GH discussions vs the forum * Create a SUPPORT doc * Add a couple badges to the README * Update Code of Conduct
This commit is contained in:
parent
5b8a5c08ce
commit
fa8186b5d8
38
.github/ISSUE_TEMPLATE/bug_report.md
vendored
38
.github/ISSUE_TEMPLATE/bug_report.md
vendored
@ -1,38 +0,0 @@
|
|||||||
---
|
|
||||||
name: Bug report
|
|
||||||
about: Create a report to help us improve
|
|
||||||
title: ""
|
|
||||||
labels: "bug"
|
|
||||||
---
|
|
||||||
|
|
||||||
### Environment
|
|
||||||
|
|
||||||
Include the result of the following commands:
|
|
||||||
- `nginx -V`
|
|
||||||
- `uname -a`
|
|
||||||
|
|
||||||
### Description
|
|
||||||
|
|
||||||
Describe the bug in full detail including expected and actual behavior.
|
|
||||||
Specify conditions that caused it. Provide the relevant part of nginx
|
|
||||||
configuration and debug log.
|
|
||||||
|
|
||||||
- [ ] The bug is reproducible with the latest version of nginx
|
|
||||||
- [ ] The nginx configuration is minimized to the smallest possible
|
|
||||||
to reproduce the issue and doesn't contain third-party modules
|
|
||||||
|
|
||||||
#### nginx configuration
|
|
||||||
|
|
||||||
```
|
|
||||||
# Your nginx configuration here
|
|
||||||
```
|
|
||||||
or share the configuration in [gist](https://gist.github.com/).
|
|
||||||
|
|
||||||
#### nginx debug log
|
|
||||||
|
|
||||||
It is advised to enable
|
|
||||||
[debug logging](http://nginx.org/en/docs/debugging_log.html).
|
|
||||||
```
|
|
||||||
# Your nginx debug log here
|
|
||||||
```
|
|
||||||
or share the debug log in [gist](https://gist.github.com/).
|
|
106
.github/ISSUE_TEMPLATE/bug_report.yml
vendored
Normal file
106
.github/ISSUE_TEMPLATE/bug_report.yml
vendored
Normal file
@ -0,0 +1,106 @@
|
|||||||
|
---
|
||||||
|
name: 🐛 Bug report
|
||||||
|
description: Create a report to help us improve
|
||||||
|
labels: bug
|
||||||
|
body:
|
||||||
|
- type: markdown
|
||||||
|
attributes:
|
||||||
|
value: |
|
||||||
|
Thanks for taking the time to fill out this bug report!
|
||||||
|
|
||||||
|
Before you continue filling out this report, please take a moment to check that your bug has not been [already reported on GitHub][issue search], is reproducible with the latest version of nginx, and does not involve any third-party modules 🙌
|
||||||
|
|
||||||
|
Remember to redact any sensitive information such as authentication credentials and/or license keys!
|
||||||
|
|
||||||
|
**Note:** If you are seeking community support, please start a new topic in the [NGINX Community forum][forum]. If you wish to discuss the codebase, please start a new thread via [GitHub discussions][discussions].
|
||||||
|
|
||||||
|
[issue search]: https://github.com/nginx/nginx/search?q=is%3Aissue&type=issues
|
||||||
|
[discussions]: https://github.com/nginx/nginx/discussions
|
||||||
|
[forum]: https://community.nginx.org
|
||||||
|
|
||||||
|
- type: textarea
|
||||||
|
id: overview
|
||||||
|
attributes:
|
||||||
|
label: Bug Overview
|
||||||
|
description: A clear and concise overview of the bug.
|
||||||
|
placeholder: When I do "X", "Y" happens instead of "Z".
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
|
||||||
|
- type: textarea
|
||||||
|
id: behavior
|
||||||
|
attributes:
|
||||||
|
label: Expected Behavior
|
||||||
|
description: A clear and concise description of what you expected to happen.
|
||||||
|
placeholder: When I do "X", I expect "Z" to happen.
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
|
||||||
|
- type: textarea
|
||||||
|
id: steps
|
||||||
|
attributes:
|
||||||
|
label: Steps to Reproduce the Bug
|
||||||
|
description: Detail the series of steps required to reproduce the bug.
|
||||||
|
placeholder: When I run "X" using [...], "X" fails with "Y" error message. If I check the terminal outputs and/or logs, I see the following info.
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
|
||||||
|
- type: textarea
|
||||||
|
id: configuration
|
||||||
|
attributes:
|
||||||
|
label: NGINX Configuration
|
||||||
|
description: Please provide your NGINX configuration. Minimize it to the smallest possible configuration that reproduces the issue.
|
||||||
|
value: |
|
||||||
|
```
|
||||||
|
# Your NGINX configuration
|
||||||
|
```
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
|
||||||
|
- type: textarea
|
||||||
|
id: environment
|
||||||
|
attributes:
|
||||||
|
label: NGINX version and build configuration options
|
||||||
|
description: Please provide details about your NGINX build.
|
||||||
|
value: |
|
||||||
|
The output of `nginx -V`: [...]
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
|
||||||
|
- type: textarea
|
||||||
|
id: environment
|
||||||
|
attributes:
|
||||||
|
label: Environment where NGINX is being built and/or deployed
|
||||||
|
description: Please provide details about your environment.
|
||||||
|
value: |
|
||||||
|
- Target deployment platform: [e.g. AWS/GCP/local cluster/etc...]
|
||||||
|
- Target OS: [e.g. RHEL 9/Ubuntu 24.04/etc...]
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
|
||||||
|
- type: textarea
|
||||||
|
id: environment
|
||||||
|
attributes:
|
||||||
|
label: Architecture where NGINX is being built and/or deployed
|
||||||
|
description: Please provide details about your deployment environment.
|
||||||
|
value: |
|
||||||
|
The output of `uname -a`: [...]
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
|
||||||
|
- type: textarea
|
||||||
|
id: logs
|
||||||
|
attributes:
|
||||||
|
label: NGINX Debug Log
|
||||||
|
description: Please provide your NGINX debug log. See this [doc](http://nginx.org/en/docs/debugging_log.html) for details on how to enable it.
|
||||||
|
value: |
|
||||||
|
```
|
||||||
|
# Your NGINX debug log
|
||||||
|
```
|
||||||
|
|
||||||
|
- type: textarea
|
||||||
|
id: context
|
||||||
|
attributes:
|
||||||
|
label: Additional Context
|
||||||
|
description: Add any other context about the problem here.
|
||||||
|
placeholder: Feel free to add any other context/information/screenshots/etc... that you think might be relevant to this issue in here.
|
12
.github/ISSUE_TEMPLATE/config.yml
vendored
Normal file
12
.github/ISSUE_TEMPLATE/config.yml
vendored
Normal file
@ -0,0 +1,12 @@
|
|||||||
|
---
|
||||||
|
blank_issues_enabled: false
|
||||||
|
contact_links:
|
||||||
|
- name: 💬 Talk to the NGINX community!
|
||||||
|
url: https://community.nginx.org
|
||||||
|
about: A community forum for NGINX users, developers, and contributors
|
||||||
|
- name: 📝 Code of Conduct
|
||||||
|
url: https://www.contributor-covenant.org/version/2/1/code_of_conduct
|
||||||
|
about: NGINX follows the Contributor Covenant Code of Conduct to ensure a safe and inclusive community
|
||||||
|
- name: 💼 For commercial & enterprise users
|
||||||
|
url: https://www.f5.com/products/nginx
|
||||||
|
about: F5 offers a wide range of NGINX products for commercial & enterprise users
|
18
.github/ISSUE_TEMPLATE/feature_request.md
vendored
18
.github/ISSUE_TEMPLATE/feature_request.md
vendored
@ -1,18 +0,0 @@
|
|||||||
---
|
|
||||||
name: Feature request
|
|
||||||
about: Suggest a feature for nginx
|
|
||||||
title: ""
|
|
||||||
labels: "feature"
|
|
||||||
---
|
|
||||||
|
|
||||||
### Describe the feature you'd like to add to nginx
|
|
||||||
|
|
||||||
A clear and concise description of the feature.
|
|
||||||
|
|
||||||
### Describe the problem this feature solves
|
|
||||||
|
|
||||||
A clear and concise description of the problem.
|
|
||||||
|
|
||||||
### Additional context
|
|
||||||
|
|
||||||
Add any other context about the feature request here.
|
|
40
.github/ISSUE_TEMPLATE/feature_request.yml
vendored
Normal file
40
.github/ISSUE_TEMPLATE/feature_request.yml
vendored
Normal file
@ -0,0 +1,40 @@
|
|||||||
|
---
|
||||||
|
name: ✨ Feature request
|
||||||
|
description: Suggest an idea for this project
|
||||||
|
labels: enhancement
|
||||||
|
body:
|
||||||
|
- type: markdown
|
||||||
|
attributes:
|
||||||
|
value: |
|
||||||
|
Thanks for taking the time to fill out this feature request!
|
||||||
|
|
||||||
|
Before you continue filling out this request, please take a moment to check that your feature has not been [already requested on GitHub][issue search] 🙌
|
||||||
|
|
||||||
|
**Note:** If you are seeking community support, please start a new topic in the [NGINX Community forum][forum]. If you wish to discuss the codebase, please start a new thread via [GitHub discussions][discussions].
|
||||||
|
|
||||||
|
[issue search]: https://github.com/nginx/nginx/search?q=is%3Aissue&type=issues
|
||||||
|
[discussions]: https://github.com/nginx/nginx/discussions
|
||||||
|
[forum]: https://community.nginx.org
|
||||||
|
|
||||||
|
- type: textarea
|
||||||
|
id: overview
|
||||||
|
attributes:
|
||||||
|
label: Feature Overview
|
||||||
|
description: A clear and concise description of what the feature request is.
|
||||||
|
placeholder: I would like this project to be able to do "X".
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
|
||||||
|
- type: textarea
|
||||||
|
id: alternatives
|
||||||
|
attributes:
|
||||||
|
label: Alternatives Considered
|
||||||
|
description: Detail any potential alternative solutions/workarounds you've used or considered.
|
||||||
|
placeholder: I have done/might be able to do "X" in this project by doing "Y".
|
||||||
|
|
||||||
|
- type: textarea
|
||||||
|
id: context
|
||||||
|
attributes:
|
||||||
|
label: Additional Context
|
||||||
|
description: Add any other context about the problem here.
|
||||||
|
placeholder: Feel free to add any other context/information/screenshots/etc... that you think might be relevant to this feature request here.
|
12
.github/pull_request_template.md
vendored
12
.github/pull_request_template.md
vendored
@ -1,10 +1,10 @@
|
|||||||
### Proposed changes
|
### Proposed changes
|
||||||
|
|
||||||
Describe the use case and detail of the change.
|
Describe the use case and detail of the change. If this PR addresses an issue on GitHub, make sure to include a link to that issue using one of the [supported keywords](https://docs.github.com/en/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue) in this PR's description or commit message.
|
||||||
|
|
||||||
If this pull request addresses an issue on GitHub, make sure to reference that
|
### Checklist
|
||||||
issue using one of the
|
|
||||||
[supported keywords](https://docs.github.com/en/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue).
|
|
||||||
|
|
||||||
Before creating a pull request, make sure to comply with the
|
Before creating a PR, run through this checklist and mark each as complete:
|
||||||
[Contributing Guidelines](https://github.com/nginx/nginx/blob/master/CONTRIBUTING.md).
|
|
||||||
|
- [ ] I have read the [contributing guidelines](/CONTRIBUTING.md).
|
||||||
|
- [ ] I have checked that NGINX compiles and runs after adding my changes.
|
||||||
|
@ -4,6 +4,11 @@
|
|||||||
<img alt="NGINX Banner">
|
<img alt="NGINX Banner">
|
||||||
</picture>
|
</picture>
|
||||||
|
|
||||||
|
[](https://www.repostatus.org/#active)
|
||||||
|
[](https://community.nginx.org)
|
||||||
|
[](https://opensource.org/license/bsd-2-clause)
|
||||||
|
[](/CODE_OF_CONDUCT.md)
|
||||||
|
|
||||||
NGINX (pronounced "engine x" or "en-jin-eks") is the world's most popular Web Server, high performance Load Balancer, Reverse Proxy, API Gateway and Content Cache.
|
NGINX (pronounced "engine x" or "en-jin-eks") is the world's most popular Web Server, high performance Load Balancer, Reverse Proxy, API Gateway and Content Cache.
|
||||||
|
|
||||||
NGINX is free and open source software, distributed under the terms of a simplified [2-clause BSD-like license](LICENSE).
|
NGINX is free and open source software, distributed under the terms of a simplified [2-clause BSD-like license](LICENSE).
|
||||||
|
33
SUPPORT.md
Normal file
33
SUPPORT.md
Normal file
@ -0,0 +1,33 @@
|
|||||||
|
# Support
|
||||||
|
|
||||||
|
## Ask a Question
|
||||||
|
|
||||||
|
We use GitHub issues for tracking bugs and feature requests related to this project.
|
||||||
|
|
||||||
|
Don't know how something in the codebase works? Curious if NGINX is capable of achieving your desired functionality? Want to discuss the implementation of an existing or in development feature? Start a GitHub discussion!
|
||||||
|
|
||||||
|
## NGINX Specific Questions and/or Issues
|
||||||
|
|
||||||
|
This isn't the right place to get support for NGINX and/or NGINX troubleshooting questions, but the following resources are available below. Thanks for your understanding!
|
||||||
|
|
||||||
|
### Community Forum
|
||||||
|
|
||||||
|
We have a community [forum](https://community.nginx.org/)! If you have any questions and/or issues, try checking out the [`Troubleshooting`](https://community.nginx.org/c/troubleshooting/8) and [`How do I...?`](https://community.nginx.org/c/how-do-i/9) categories. Both fellow community members and NGINXers might be able to help you! :)
|
||||||
|
|
||||||
|
### Documentation
|
||||||
|
|
||||||
|
For a comprehensive list of all NGINX directives, check out <https://nginx.org>.
|
||||||
|
|
||||||
|
For a comprehensive list of administration and deployment guides for all NGINX products, check out <https://docs.nginx.com>.
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
Please see the [contributing guide](/CONTRIBUTING.md) for guidelines on how to best contribute to this project.
|
||||||
|
|
||||||
|
## Commercial Support
|
||||||
|
|
||||||
|
Commercial support for this project is available. Please get in touch with [F5 sales](https://www.f5.com/products/get-f5/) or check your contract details for more information!
|
||||||
|
|
||||||
|
## Community Support
|
||||||
|
|
||||||
|
Community support is offered on a best effort basis through any of our active communities.
|
Loading…
Reference in New Issue
Block a user