aboutsummaryrefslogtreecommitdiff
path: root/.forgejo/issue_template/issue_template.yml
blob: eae2e492b42b85b5a8776d8397174b28fb181b92 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
name: Bug Report
description: File a bug report
labels: ["bug"]
body:
  - type: markdown
    attributes:
      value: |
        Please provide as many details as possible, we must be able to
        understand the bug in order to fix it.

        Don't forget to search the issue tracker in case there is
        already an open issue for the bug you found.
  - type: input
    id: version
    attributes:
      label: Foot Version
      description: "The output of `foot --version`"
      placeholder: "foot version: 1.17.2-11-gc4f13809 (May 20 2024, branch 'master') +pgo +ime +graphemes -assertions"
    validations:
      required: true
  - type: input
    id: term
    attributes:
      label: TERM environment variable
      description: "The output of `echo $TERM`"
      placeholder: "foot"
    validations:
      required: true
  - type: input
    id: compositor
    attributes:
      label: Compositor Version
      description: "The name and version of your compositor"
      placeholder: "sway version 1.9"
    validations:
      required: true
  - type: input
    id: distro
    attributes:
      label: Distribution
      description: "The name of the Linux distribution, or BSD flavor, you are running"
      placeholder: "Arch Linux"
    validations:
      required: true
  - type: textarea
    id: config
    attributes:
      label: Foot config
      description: Paste your entire `foot.ini` here
    validations:
      required: true
  - type: textarea
    id: repro
    attributes:
      label: Description of Bug and Steps to Reproduce
      description: |
        Exactly what steps can someone else take to see the bug
        themselves? What happens?
    validations:
      required: true
  - type: markdown
    attributes:
      value: |
        Please provide as many details as possible, we must be able to
        understand the bug in order to fix it.

        Other software
        --------------

        **Compositors**: have you tested other compositors? Does the
        issue happen on all of them, or only your main compositor?

        **Terminal multiplexers**: are you using tmux, zellij, or any
        other terminal multiplexer?  Does the bug happen in a plain
        foot instance?

        **IME** do you use an IME (e.g. fcitx5, ibus etc)? Which one?
        Does the bug happen if you disable the IME?

        Obtaining logs and stacktraces
        ------------------------------

        Use a [debug
        build](https://codeberg.org/dnkl/foot/src/branch/master/INSTALL.md#debug-build)
        of foot if possible, to get a better quality stacktrace in
        case of a crash.

        Run foot with logging enabled:
        ```sh
        foot -d info 2> foot.log
        ```

        In many cases, tracing the Wayland communication is extremely helpful:
        ```sh
        WAYLAND_DEBUG=1 foot -d info 2> foot.wayland.log
        ```

        Reproduce your problem as quickly as possible, and then exit foot.
  - type: textarea
    id: logs
    attributes:
      label: Relevant logs, stacktraces, etc.
  - type: markdown
    attributes:
      value: |
        Please attach files instead of pasting the logs, if the logs are large