|
| 1 | +# Contributing to WeeChat Relay |
| 2 | + |
| 3 | +## Reporting bugs |
| 4 | + |
| 5 | +First, some basic things: |
| 6 | + |
| 7 | +- Use only English to communicate with developers. |
| 8 | +- Search in issues if the same problem or feature request has already been |
| 9 | + reported (a duplicate is waste of time for you and the developers!). |
| 10 | +- If you can, please check if the problem has been fixed in development version |
| 11 | + (if you are using a stable release or old version). |
| 12 | +- Report only one bug or feature request per issue. |
| 13 | + |
| 14 | +### Security reports |
| 15 | + |
| 16 | +Please **DO NOT** file a GitHub issue for security related problems, but send an |
| 17 | + |
| 18 | + |
| 19 | +### Required info |
| 20 | + |
| 21 | +When reporting [issues](https://github.com/weechat/weechat-relay/issues) on GitHub, |
| 22 | +please include: |
| 23 | + |
| 24 | +- The **library version**: output of `weechat-relay-cli -v` |
| 25 | +- The **version of the remote WeeChat**: the output of `/v` in WeeChat, |
| 26 | + for example: _WeeChat 2.5-dev (git: v2.4-67-g413221bc9)_. + |
| 27 | +- Your **operating system**: its name and version (examples: Linux Debian Bookworm, |
| 28 | + FreeBSD 13.0, Windows/Cygwin 64-bit, Windows/Ubuntu 64-bit...). |
| 29 | +- The **steps to reproduce**: if possible, please include a reproducible example: |
| 30 | + explain the steps which led you to the problem. |
| 31 | +- The **gdb's backtrace** (only for a crash): if you can reproduce the crash |
| 32 | + (or if you have a core file), please include the backtrace from gdb. |
| 33 | +- The **actual result**. |
| 34 | +- The **expected result**: the correct result you are expecting. |
| 35 | + |
| 36 | +## Feature requests |
| 37 | + |
| 38 | +WeeChat Relay is under active development, so your idea may already have been |
| 39 | +implemented, or scheduled for a future version (you can check in |
| 40 | +[milestones](https://github.com/weechat/weechat-relay/milestones) on GitHub). |
| 41 | + |
| 42 | +Pull requests on GitHub are welcome for minor new features. |
| 43 | + |
| 44 | +For major new features, it's better to discuss about it in IRC |
| 45 | +(server: `irc.libera.chat`, channel `#weechat`). |
| 46 | + |
| 47 | +Before submitting any pull request, be sure you have read the |
| 48 | +[coding rules](https://weechat.org/doc/weechat/dev/#coding_rules) |
| 49 | +in WeeChat Developer's guide, which contains info about styles used, naming |
| 50 | +convention and other useful info. |
0 commit comments