TeamCodeArena / DeliverEase

DeliverEase is an innovative platform designed to empower delivery partners and foster seamless connections between buyers and sellers without the need for intermediaries.
MIT License
13 stars 17 forks source link

Create bug_report.yml #96

Closed N3v1 closed 1 year ago

N3v1 commented 1 year ago

Hi @SID262000, I created a .yml file for a new bug report form

For that, I created a .github/ISSUE_TEMPLATE folder

Best regards NH

N3v1 commented 1 year ago

Hi @SID262000, I've seen many other repos use bug reporting forms, so I thought it would be helpful if we could use it in this repo as well. Sometimes I feel like I don't know what to write in a bug report - in this situation, a bug report form would be helpful. If you don't have a bug report form, most people just write something like "function xy doesn't work" and don't provide any other helpful information like screenshots, descriptions, recreations, etc.

An example of a repo using a bug report form is my Quick Convert repo - see here.

If you click on the link you should see something like this:

Bildschirmfoto 2023-08-22 um 15 30 58

The bug report form for this repo consists of 6 elements:

  1. The description of the issue
    - type: textarea
    attributes:
      label: Description
      placeholder: >-
        A clear and concise description of what the bug is...
    validations:
      required: true
  2. Steps to reliably reproduce the behavior
    - type: textarea
    attributes:
      label: To Reproduce
      description: >-
        Steps to reliably reproduce the behavior.
      placeholder: |
        1. Go to '...'
        2. Click on '....'
        3. Scroll down to '....'
        4. See error
    validations:
      required: true
  3. A clear and concise description of what you expected to happen
    - type: textarea
    attributes:
      label: Expected Behavior
      placeholder: >-
        A clear and concise description of what you expected to happen...
    validations:
      required: true
  4. Any other context or considerations about the bug
    - type: textarea
    attributes:
      label: Additional Context
      placeholder: >-
        Any other context or considerations about the bug...
  5. Screenshots
    - type: textarea
    attributes:
      label: Screenshots
      placeholder: >-
        If applicable, please provide relevant screenshots or screen recordings...
  6. Checkbox - "Is there an existing issue for this?"
    - type: checkboxes
    id: new-bug
    attributes:
      label: Is there an existing issue for this?
      description: Please search to see if an issue already exists for the bug you encountered.
      options:
      - label: I have searched the existing issues
        required: true

In the first lines of the bug_report.yml file you can find something like that:

name: 🔴 Bug report
description: Something is not working as expected.
title: 🔴 <bug name>
labels: bug

If you have any other questions, just let me know Best regards NH

N3v1 commented 1 year ago

Hi @SID262000, I added a config.yml and a feature_request.yml in the lastest commit.

What does the config.yml do?

With the config.yml you can configure the issue template selection:

Bildschirmfoto 2023-08-22 um 16 13 05

Furthermore, I created a feature request form that functions the same as the bug report just with small changes: