File: CONTRIBUTING.md

package info (click to toggle)
neomutt 20250510%2Bdfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 23,372 kB
  • sloc: ansic: 171,730; sh: 5,357; perl: 1,121; tcl: 1,065; python: 443; makefile: 48
file content (71 lines) | stat: -rw-r--r-- 2,601 bytes parent folder | download | duplicates (6)
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
Hello and thank you for your interest in our project :)


Tips for a good bugreport
-------------------------------

* Help us help you! The more details you give, the better we\'ll be able to
  help you out.

* Please use markdown syntax, especially for backtraces and config files!

* Please provide a minimal working example. That means, you should try to
  replicate your issue with the minimal configuration from your muttrc and/or
  any other relevant config files. These are the details you should be posting.

* Sometimes even small and inconspicuous details matter, so please be very
  careful when writing down the steps to reproduce your problem.

* Please give us a list of program versions of **every** program relevant to
  your report.



Tips for writing a good feature request
---------------------------------------

* Describe your problem and especially the context of it very detailed. It has
  happened many times, that the problem could be solved without implementing
  another feature.

* Please describe also your desired solution carefully. Nothing is more
  frustrating - for both you and us, as developers - if we understand your
  problem the wrong way and implement something which doesn't help you.



Tips for writing good pull requests
---------------------------------------

* The first line should be a short (50 characters or less) summary of your
  commit message. If you can't find a short enough one-line summary, split the
  commit into multiple ones.

* Keep one line between the one-line summary and the body.

* Use bullet points in the body of the commit message to separate multiple
  things you did.

* your commits should be clear and concise. That means also you shouldn't sum up
  two features or two bug fixes into one commit. If you do, it makes both bug
  fixes or features harder to understand. Also, don't hesitate to
  [rewrite](https://git-scm.com/book/en/v2/Git-Tools-Rewriting-History) the
  Github history of your development branch.

* Wrap the body of the commit message at around 80 characters.

* if your commit addresses a particular PR, commit or Issue, please say so in
  your commit. The Github documentation
  ([1](https://help.github.com/articles/autolinked-references-and-urls/)
  and [2](https://help.github.com/articles/closing-issues-via-commit-messages/))
  can help you with that.

* Please eliminate any warnings gcc or any other tool produces during the
  compilation stage.

* If your commit addresses only a specific method or a specific file, please say
  so in your commit.

Thank you for your help!

The Neomutt Team.