From b3eb629785e63fd0bb483edf064c041b657c5c0a Mon Sep 17 00:00:00 2001 From: tfny <95721958+tfny@users.noreply.github.com> Date: Fri, 10 Jun 2022 12:06:10 -0500 Subject: [PATCH] Update the contributing docs for clarity and to encourage community activity --- .../content/contributing/submitting-issues.md | 43 ++++++++++++------- 1 file changed, 28 insertions(+), 15 deletions(-) diff --git a/docs/content/contributing/submitting-issues.md b/docs/content/contributing/submitting-issues.md index 6bcb42679..9a06c3e99 100644 --- a/docs/content/contributing/submitting-issues.md +++ b/docs/content/contributing/submitting-issues.md @@ -8,41 +8,54 @@ description: "Help us help you! Learn how to submit an issue, following the guid Help Us Help You! {: .subtitle } +Issues are perfect for requesting a feature/enhancement or reporting a suspected bug. We use the [GitHub issue tracker](https://github.com/traefik/traefik/issues) to keep track of issues in Traefik. The process of sorting and checking the issues is a daunting task, and requires a lot of work (more than an hour a day ... just for sorting). -To save us some time and get quicker feedback, be sure to follow the guide lines below. +To help us (and other community members) quickly and easily understand what you need, +be sure to follow the guidelines below. !!! important "Getting Help Vs Reporting an Issue" The issue tracker is not a general support forum, but a place to report bugs and asks for new features. - For end-user related support questions, try using first: - - - the Traefik community forum: [![Join the chat at https://community.traefik.io/](https://img.shields.io/badge/style-register-green.svg?style=social&label=Discourse)](https://community.traefik.io/) + For end-user related support questions, try using the [Traefik Community Forum](https://community.traefik.io/) + [![Join the chat at https://community.traefik.io/](https://img.shields.io/badge/style-register-green.svg?style=social&label=Traefik%20Community%20Forum)](https://community.traefik.io/) ## Issue Title The title must be short and descriptive. (~60 characters) -## Description +Examples: -Follow the [issue template](https://github.com/traefik/traefik/blob/master/.github/ISSUE_TEMPLATE.md) as much as possible. - -Explain us in which conditions you encountered the issue, what is your context. - -Remain as clear and concise as possible - -Take time to polish the format of your message so we'll enjoy reading it and working on it. -Help the readers focus on what matters, and help them understand the structure of your message (see the [GitHub Markdown Syntax](https://docs.github.com/en/get-started/writing-on-github)). +* Bug: Duplicate requests in access logs +* Feature: Support TCP ## Feature Request -Traefik is an open-source project and aims to be the best edge router possible. +Traefik is an open source project and aims to be the best edge router possible. Remember when asking for new features that these must be useful to the majority (and not only useful in edge case scenarios, or hack-like setups). +Follow the [issue template](https://github.com/traefik/traefik/blob/master/.github/ISSUE_TEMPLATE/feature-request.yml) as much as possible. -Do you best to explain what you're looking for, and why it would improve Traefik for everyone. +Do your best to explain what you're looking for, and why it would improve Traefik for everyone. +Be detailed and share the use-case(s) to allow us to see the value of your feature request as quickly as possible. +Features with a lot of positive interaction (claps, +1s, conversation about how this would impact them) indicate higher community interest and help us to prioritize. + +If you are interested in creating a PR for your feature request, let us know in the the issue so we can work with you. +It can take a lot of work to make sure a PR can integrate with our existing code and planning with the team ahead of time can make sure that your PR can be accepted and merged quickly. + +## Issues or Possible Bug Reports + +Follow the [issue template](https://github.com/traefik/traefik/blob/master/.github/ISSUE_TEMPLATE/bug_report.yml) as much as possible. + +Explain the conditions in which you encountered the issue; what is your context? +Share any logs you may have and make sure to share the steps it takes to reproduce your issue or bug. + +Remain as clear and concise as possible. + +Take time to polish the format of your message so we'll enjoy reading it and working on it. +Help your readers focus on what matters and help them understand the structure of your message (see the [GitHub Markdown Syntax](https://docs.github.com/en/get-started/writing-on-github)). ## International English