nicegui/.github/DISCUSSION_TEMPLATE/q-a.yml

body:
  - type: markdown
    attributes:
      value: |
        Thanks for your interest in NiceGUI! 🚀

        Please follow these instructions, fill every question, and do every step. 🙏

        We're asking this because answering questions and solving problems on GitHub consumes a lot of the time.

        By asking questions in a structured way (following this) it will be much easier to help you.

        And there's a high chance that you will find the solution along the way and you won't even have to submit it and wait for an answer. 😎
  - type: checkboxes
    id: checks
    attributes:
      label: First Check
      description: Please confirm and check all the following options.
      options:
        - label: I added a very descriptive title here.
          required: true
        - label: I have checked the [FAQs](/zauberzeug/nicegui/wiki/FAQs) for a similar question and didn't find it.
          required: true
        - label: I used the GitHub search to find a similar [question](https://github.com/zauberzeug/nicegui/discussions/categories/q-a) and didn't find it.
          required: true
        - label: I searched the NiceGUI documentation, with the integrated search.
          required: true
        - label: I already searched online "How to X in NiceGUI" and didn't find any information.
          required: true
  - type: textarea
    id: example
    attributes:
      label: Example Code
      description: |
        Please add a self-contained, [minimal, reproducible, example](https://stackoverflow.com/help/minimal-reproducible-example) with your use case.

        If one can copy it, run it, and see it right away, there's a much higher chance we (or someone from the community) will be able to help you.

      placeholder: |
        from nicegui import ui

        ui.label('Hello, world!')

        ui.run()
      render: python
    validations:
      required: true
  - type: textarea
    id: description
    attributes:
      label: Description
      description: |
        What is the problem, question, or error?

        Write a short description telling us what you are doing, what you expect to happen, and what is currently happening.
      placeholder: |
        Start the app.
        The browser opens and shows a label with text "Hello, world!".
        But I expected it to show "Hello, Alice!".
    validations:
      required: true
  - type: input
    id: nicegui-version
    attributes:
      label: NiceGUI Version
      description: |
        What NiceGUI version are you using?

        You can find the NiceGUI version with:

        ```bash
        python -c "import nicegui; print(nicegui.__version__)"
        ```
    validations:
      required: true
  - type: input
    id: python-version
    attributes:
      label: Python Version
      description: |
        What Python version are you using?

        You can find the Python version with:

        ```bash
        python --version
        ```
    validations:
      required: true
  - type: dropdown
    id: browser
    attributes:
      label: Browser
      description: What browser have you tested with?
      multiple: true
      options:
        - Chrome
        - Safari
        - Edge
        - Firefox
        - Opera
        - Samsung Internet
        - Other
    validations:
      required: true
  - type: dropdown
    id: os
    attributes:
      label: Operating System
      description: What operating system are you on?
      options:
        - Linux
        - macOS
        - Windows
        - Android
        - iOS
        - Other
    validations:
      required: true
  - type: textarea
    id: context
    attributes:
      label: Additional Context
      description: Add any additional context information or screenshots you think are useful.