sp-dev-fx-webparts/.github/ISSUE_TEMPLATE/bug-report.yml

name: 🐞 Bug or error report
description: Report an anomaly or unexpected behavior with a sample from this repository.
labels: ['type:bug-suspected']

body:
- type: markdown
  attributes:
    value: |
      - [x] Bug

      Thank you for reporting a bug! Use the sections below to submit a bug ONLY if it's related to samples in this repo. If you have an issue or question about the SharePoint Framework or its documentation, please submit it at https://aka.ms/spdev-issues. 
      
      > **IMPORTANT**
      > Before you submit an issue, please follow the **[troubleshooting steps](https://github.com/pnp/sp-dev-fx-webparts/wiki/Troubleshooting-issues-with-samples)**. 

      - Follow our guidance on [How To Create Good Issues](https://github.com/pnp/sp-dev-fx-webparts/wiki/How-to-Create-Good-Issues).
      - All bug reports are welcome - we want to fix them!
      - This repo is maintained by volunteers. Please be courteous and patient. 🙂
      - Remember to include sufficient details and context.
      - If you have multiple questions, suggestions, or bugs, please submit them in separate issues.
      - We accept pull requests. If you know how to fix it - go ahead! If you know how to make it - go ahead! If you're unsure how to do a pull request, consider signing up for a free [Sharing is Caring First-Time Contributor](http://aka.ms/sharing-is-caring#pnp-sic-first-time-contributor) session.

      Please provide the following details about the issue you encountered.  *Issues that do not provide the information requested in this form will be flagged as **incomplete** & automatically closed.*      

- type: dropdown
  id: disclaimer
  validations:
    required: true
  attributes:
    label: Disclaimer
    description: I have read and understood the **[support guidelines](https://github.com/pnp/sp-dev-fx-webparts/blob/main/SUPPORT.md)**, and followed the steps listed in **[troubleshooting steps](https://github.com/pnp/sp-dev-fx-webparts/wiki/Troubleshooting-issues-with-samples)** and **[how to create good issues](https://github.com/pnp/sp-dev-fx-webparts/wiki/How-to-Create-Good-Issues)** before submitting this issue. I understand that my issue may be closed if I do not follow the guidelines.
    options:
    - "Yes"
- type: input
  id: sample
  validations:
    required: true
  attributes:
    label: Sample
    description: |
        Which sample are you having troubles with?
        
        Use the sample name or URL. We don't want to be spend all this time diagnosing issues about the wrong sample, do we?        

- type: input
  id: authors
  validations:
    required: true
  attributes:
    label: Contributor(s)
    description: |
        Who wrote the sample?
        
        Because of the way this repository is configured, samples contributors do not get a notification when you create an issue. 
        
        For the section above **@mention any of the sample contributors**. Contributors' GitHub handle can be found on the main sample documentation page, under the "Contributors" section. 
        
        Issues without an @mention will be closed automatically, as contributors won't get notified.
        
        **NOTE:** Don't @mention the repo maintainers, they already get notified.        

- type: markdown
  attributes:
    value: |
      Provide a clear & concise description of what the bug is. Please follow our guidance on [How To Create Good Issues](https://github.com/pnp/sp-dev-fx-webparts/wiki/How-to-Create-Good-Issues) which explains how to apply formatting, adding references & resources, screenshots, etc. 
      
      **Do not attach ZIP files** of your code or compiled projects - instead, please publish your code to a public GitHub repo & post a link to it.      

- type: textarea
  id: what-happened
  attributes:
    label: What happened?
    description: Describe the observed behavior
    placeholder: Tell us what you see!
  validations:
    required: true

- type: textarea
  id: steps
  attributes:
    label: Steps to reproduce
    description: How do you reproduce this? Please provide as much step-by-step detail as possible.
    value: |
      1.
      2.
      3.      
  validations:
    required: true

- type: textarea
  id: expected
  attributes:
    label: Expected behavior
    description: What did you expect to happen when the reproduce steps are followed?
    placeholder: Tell us what you expected to see!
  validations:
    required: true

- type: markdown
  attributes:
    value: |
      When solving bugs, most time is spent going back and forth with the issue contributors asking for more information about their environment. 
      
      Save yourself some time (and those who are trying to help you); provide us with your environment information so we can reproduce the issue.
      
      We're not trying to be difficult here, we just want to help as quickly as possible.      

- type: dropdown
  id: sharepoint-version
  validations:
    required: true
  attributes:
    label: Target SharePoint environment
    options:
      - SharePoint Online
      - SharePoint Server 2019 (on-premise)
      - SharePoint Server 2016 (on-premise)

- type: dropdown
  id: environment-os
  attributes:
    label: Developer environment
    options:
      - Windows
      - macOS
      - Linux

- type: checkboxes
  id: browsers
  attributes:
    label: Browsers    
    description: |
      What browser(s) / client(s) have you tested
      
      Select the browser(s)/clients this submission is relevant to.      

    options:
      - label: Internet Explorer
      - label: Microsoft Edge
      - label: Google Chrome
      - label: FireFox
      - label: Safari
      - label: mobile (iOS/iPadOS)
      - label: mobile (Android)
      - label: not applicable
      - label: other (enter in the "Additional environment details" area below)

- type: input
  id: installed-node
  validations:
    required: true
  attributes:
    label:  What version of Node.js is currently installed on your workstation?
    description: |
        Run `node -v` and paste the results.         

- type: input
  id: required-node
  validations:
    required: true
  attributes:
    label:  What version of Node.js is required by the sample?
    description: |
        You can find the compatible versions of React in the sample's `README.md`, in the **Compatibility** section.
                
- type: textarea
  id: spfxdoctor
  validations:
    required: true
  attributes:
    label: Paste the results of SPFx doctor
    description: |
        Run `m365 spfx doctor -o text` and paste the results. If you cannot run SPFx doctor, provide the error message or an explanation why you were not able to provide the information that is crucial to being able to help you.

        Issues without SPFx doctor results may be closed automatically.
        
        Follow [the steps](https://github.com/pnp/sp-dev-fx-webparts/wiki/Troubleshooting-issues-with-samples#run-spfx-doctor) listed in [troubleshooting issues with samples](https://github.com/pnp/sp-dev-fx-webparts/wiki/Troubleshooting-issues-with-samples)        

- type: textarea
  id: moar
  attributes:
    label: Additional environment details
    description: Include as much detail about the environment you're targeting. This is required if "other (enter below)" is selected in the previous field.