Stalwart/.github/DISCUSSION_TEMPLATE/issue-triage.yml

labels: ["needs-confirmation"]
body:
  - type: markdown
    attributes:
      value: |
        > [!IMPORTANT]
        > Please review the [documentation](https://stalw.art/docs/), check the [FAQ](https://stalw.art/docs/faq), and search existing [Discussions](https://github.com/stalwartlabs/stalwart/discussions) and [Issues](https://github.com/stalwartlabs/stalwart/issues?q=sort%3Areactions-desc) before opening a new Discussion.
        >
        > Most reported issues turn out to be configuration problems rather than actual bugs. Starting here helps us triage effectively—if this is confirmed as a bug, we'll create an Issue for tracking.
  - type: markdown
    attributes:
      value: "# Issue Details"
  - type: textarea
    attributes:
      label: Issue Description
      description: |
        Provide a detailed description of the issue. Include relevant information, such as:
        - The feature or configuration you encounter the issue with.
        - Screenshots, logs, or other supporting information.
        - If this is a regression of an existing issue that was closed or resolved, please include the previous reference (Discussion, Issue, PR, commit).

        > [!TIP]
        > **Not sure what information to include?**
        > - **Authentication issues:** Include the authentication method (LDAP, OIDC, SQL, internal), relevant sanitized config snippets, and error messages from logs.
        > - **Email delivery issues:** Include relevant SMTP logs (with `trace` level if possible), sender/recipient domains, and any bounce messages.
        > - **IMAP/JMAP issues:** Include the client being used, the specific operation failing, and relevant protocol logs.
        > - **Performance issues:** Include server specs, number of accounts/messages, and resource usage metrics.
      placeholder: |
        When trying to send an email via SMTP, the connection is accepted but the message is rejected with error 550.
    validations:
      required: true
  - type: textarea
    attributes:
      label: Expected Behavior
      description: |
        Describe how you expect Stalwart to behave in this situation. Include any relevant documentation links.
      placeholder: |
        The email should be accepted and delivered to the recipient's mailbox.
    validations:
      required: false
  - type: textarea
    attributes:
      label: Actual Behavior
      description: |
        Describe how Stalwart actually behaves in this situation. If it is not immediately obvious how the actual behavior differs from the expected behavior described above, please mention the deviation specifically.
      placeholder: |
        The email is rejected with error: "550 5.7.1 Relay access denied"
    validations:
      required: false
  - type: textarea
    attributes:
      label: Reproduction Steps
      description: |
        Provide a detailed set of step-by-step instructions for reproducing this issue.
      placeholder: |
        1. Configure Stalwart with the attached configuration.
        2. Attempt to send an email from user@example.com to external@domain.com.
        3. Observe the 550 error in the SMTP session.
    validations:
      required: true
  - type: textarea
    attributes:
      label: Relevant Log Output
      description: |
        Please copy and paste any relevant log output. Set logging level to `trace` if you can't find any relevant errors in the log.
      render: shell
  - type: dropdown
    attributes:
      label: Stalwart Version
      description: What version of Stalwart are you running?
      options:
        - v0.15.x
        - v0.14.x
        - v0.13.x
        - v0.12.x or lower
    validations:
      required: true
  - type: dropdown
    attributes:
      label: Installation Method
      description: How did you install Stalwart?
      options:
        - Docker
        - Binary (Linux)
        - Binary (macOS)
        - Binary (FreeBSD)
        - Binary (Windows)
        - NixOS
        - Built from source
    validations:
      required: true
  - type: dropdown
    attributes:
      label: Database Backend
      description: What database are you using for the data store?
      options:
        - RocksDB
        - FoundationDB
        - PostgreSQL
        - MySQL
        - SQLite
    validations:
      required: false
  - type: dropdown
    attributes:
      label: Blob Storage
      description: What blob storage are you using?
      options:
        - RocksDB
        - FoundationDB
        - PostgreSQL
        - MySQL
        - SQLite
        - Filesystem
        - S3-compatible
        - Azure
    validations:
      required: false
  - type: dropdown
    attributes:
      label: Directory Backend
      description: Where is your directory/user database located?
      options:
        - Internal
        - SQL
        - LDAP
        - OIDC
    validations:
      required: false
  - type: textarea
    attributes:
      label: Additional Context
      description: |
        Add any other context about the problem here. This could include:
        - Client software and versions (Thunderbird, Apple Mail, K-9, etc.)
        - Proxy or reverse proxy configuration (nginx, Traefik, etc.)
        - Network setup (NAT, firewall rules, etc.)
    validations:
      required: false
  - type: markdown
    attributes:
      value: |
        # Acknowledgements
        > [!TIP]
        > Use these links to review existing [Discussions](https://github.com/stalwartlabs/stalwart/discussions) and [Issues](https://github.com/stalwartlabs/stalwart/issues?q=sort%3Areactions-desc).
  - type: checkboxes
    attributes:
      label: "I acknowledge that:"
      options:
        - label: I have reviewed the documentation and FAQ and confirm that my issue is NOT addressed there.
          required: true
        - label: I have searched the Stalwart repository (both open and closed Discussions and Issues) and confirm this is not a duplicate.
          required: true
        - label: I have set the logging level to `trace` and included relevant log output if applicable.
          required: false
        - label: I agree to follow the project's [Code of Conduct](https://github.com/stalwartlabs/.github/blob/main/CODE_OF_CONDUCT.md).
          required: true