Mercurial > vim

annotate CONTRIBUTING.md @ 35183:9a1ac66c788d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
CI: Upload failed screendump tests when run in github actions Commit: https://github.com/vim/vim/commit/8314de8fd4aa4d18fc524f960f5d683a2d8cba32 Author: Christian Brabandt <cb@256bit.org> Date: Wed May 15 21:48:11 2024 +0200 CI: Upload failed screendump tests when run in github actions It's a bit of a pain to debug failing screendump tests without knowing exactly what went wrong. Therefore include actions/upload-artifact for the Github CI runners and have them uploaded those failing screen dump tests automatically. Let's add this step to each of the Linux/MacOS/Windows workflows but do not duplicate the code, factor it out to a single file .github/actions/screendump/action.yml and reference this one from the main ci.yml file Example: https://github.com/chrisbra/vim/actions/runs/9085493619 closes: #14771 Co-authored-by: dundargoc <gocdundar@gmail.com> Co-authored-by: Aliaksei Budavei <0x000c70@gmail.com> Signed-off-by: Christian Brabandt <cb@256bit.org>
author Christian Brabandt <cb@256bit.org>
date Wed, 15 May 2024 22:00:04 +0200
parents be122dc08867
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7068
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
1 # Contributing to Vim
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
2
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
3 Patches are welcome in whatever form.
33760
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
4 Discussions about patches happen on the [vim-dev][0] mailing list.
7068
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
5 If you create a pull request on GitHub it will be
33760
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
6 forwarded to the vim-dev mailing list. You can also send your patch there
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
7 directly (but please note, the initial posting is subject to moderation).
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
8 In that case an attachment with a unified diff format is preferred.
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
9 Information about the mailing list can be found [on the Vim website][0]
7068
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
10
17640
c12c811695f7 patch 8.1.1817: github contribution text is incomplete
Bram Moolenaar <Bram@vim.org>
parents: 16285
diff changeset
11 A pull request has the advantage that it will trigger the Continuous
c12c811695f7 patch 8.1.1817: github contribution text is incomplete
Bram Moolenaar <Bram@vim.org>
parents: 16285
diff changeset
12 Integration tests, you will be warned of problems (you can ignore the coverage
c12c811695f7 patch 8.1.1817: github contribution text is incomplete
Bram Moolenaar <Bram@vim.org>
parents: 16285
diff changeset
13 warning, it's noisy).
c12c811695f7 patch 8.1.1817: github contribution text is incomplete
Bram Moolenaar <Bram@vim.org>
parents: 16285
diff changeset
14
c12c811695f7 patch 8.1.1817: github contribution text is incomplete
Bram Moolenaar <Bram@vim.org>
parents: 16285
diff changeset
15 Please consider adding a test. All new functionality should be tested and bug
c12c811695f7 patch 8.1.1817: github contribution text is incomplete
Bram Moolenaar <Bram@vim.org>
parents: 16285
diff changeset
16 fixes should be tested for regressions: the test should fail before the fix and
c12c811695f7 patch 8.1.1817: github contribution text is incomplete
Bram Moolenaar <Bram@vim.org>
parents: 16285
diff changeset
17 pass after the fix. Look through recent patches for examples and find help
c12c811695f7 patch 8.1.1817: github contribution text is incomplete
Bram Moolenaar <Bram@vim.org>
parents: 16285
diff changeset
18 with ":help testing". The tests are located under "src/testdir".
c12c811695f7 patch 8.1.1817: github contribution text is incomplete
Bram Moolenaar <Bram@vim.org>
parents: 16285
diff changeset
19
c12c811695f7 patch 8.1.1817: github contribution text is incomplete
Bram Moolenaar <Bram@vim.org>
parents: 16285
diff changeset
20 Contributions will be distributed with Vim under the Vim license. Providing a
c12c811695f7 patch 8.1.1817: github contribution text is incomplete
Bram Moolenaar <Bram@vim.org>
parents: 16285
diff changeset
21 change to be included implies that you agree with this and your contribution
c12c811695f7 patch 8.1.1817: github contribution text is incomplete
Bram Moolenaar <Bram@vim.org>
parents: 16285
diff changeset
22 does not cause us trouble with trademarks or patents. There is no CLA to sign.
7068
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
23
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
24 # Reporting issues
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
25
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
26 We use GitHub issues, but that is not a requirement. Writing to the Vim
33760
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
27 mailing list is also fine.
7068
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
28
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
29 Please use the GitHub issues only for actual issues. If you are not 100% sure
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
30 that your problem is a Vim issue, please first discuss this on the Vim user
33760
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
31 mailing list. Try reproducing the problem without any of your plugins or settings:
7068
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
32
16208
a23c883685cb Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 14372
diff changeset
33 vim --clean
7068
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
34
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
35 If you report an issue, please describe exactly how to reproduce it.
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
36 For example, don't say "insert some text" but say what you did exactly:
33760
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
37 `ahere is some text<Esc>`.
7076
6ad58a7e995b commit https://github.com/vim/vim/commit/544780248b5876339b316703fc2f330a9d316c45
Christian Brabandt <cb@256bit.org>
parents: 7068
diff changeset
38 Ideally, the steps you list can be used to write a test to verify the problem
6ad58a7e995b commit https://github.com/vim/vim/commit/544780248b5876339b316703fc2f330a9d316c45
Christian Brabandt <cb@256bit.org>
parents: 7068
diff changeset
39 is fixed.
7068
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
40
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
41 Feel free to report even the smallest problem, also typos in the documentation.
a55f35ed381b commit https://github.com/vim/vim/commit/6017f3799dbb744fc34894d968b36729e607203e
Christian Brabandt <cb@256bit.org>
parents:
diff changeset
42
33760
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
43 You can find known issues in the todo file: `:help todo`.
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
44 Or open [the todo file][todo list] on GitHub to see the latest version.
7084
1c039023af1c commit https://github.com/vim/vim/commit/b58988b832b69b52dfefeca338ea4802d0c4cdca
Christian Brabandt <cb@256bit.org>
parents: 7076
diff changeset
45
1c039023af1c commit https://github.com/vim/vim/commit/b58988b832b69b52dfefeca338ea4802d0c4cdca
Christian Brabandt <cb@256bit.org>
parents: 7076
diff changeset
46 # Syntax, indent and other runtime files
1c039023af1c commit https://github.com/vim/vim/commit/b58988b832b69b52dfefeca338ea4802d0c4cdca
Christian Brabandt <cb@256bit.org>
parents: 7076
diff changeset
47
1c039023af1c commit https://github.com/vim/vim/commit/b58988b832b69b52dfefeca338ea4802d0c4cdca
Christian Brabandt <cb@256bit.org>
parents: 7076
diff changeset
48 The latest version of these files can be obtained from the repository.
35129
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
49 They are usually not updated with numbered patches. However, they may
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
50 or may not work with older Vim releases (since they may contain new features).
7084
1c039023af1c commit https://github.com/vim/vim/commit/b58988b832b69b52dfefeca338ea4802d0c4cdca
Christian Brabandt <cb@256bit.org>
parents: 7076
diff changeset
51
1c039023af1c commit https://github.com/vim/vim/commit/b58988b832b69b52dfefeca338ea4802d0c4cdca
Christian Brabandt <cb@256bit.org>
parents: 7076
diff changeset
52 If you find a problem with one of these files or have a suggestion for
1c039023af1c commit https://github.com/vim/vim/commit/b58988b832b69b52dfefeca338ea4802d0c4cdca
Christian Brabandt <cb@256bit.org>
parents: 7076
diff changeset
53 improvement, please first try to contact the maintainer directly.
35129
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
54 Look in the header of the file for the name, email address, github handle and/or
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
55 upstream repository. You may also check the [MAINTAINERS][11] file.
7084
1c039023af1c commit https://github.com/vim/vim/commit/b58988b832b69b52dfefeca338ea4802d0c4cdca
Christian Brabandt <cb@256bit.org>
parents: 7076
diff changeset
56
33760
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
57 The maintainer will take care of issues and send updates to the Vim project for
7084
1c039023af1c commit https://github.com/vim/vim/commit/b58988b832b69b52dfefeca338ea4802d0c4cdca
Christian Brabandt <cb@256bit.org>
parents: 7076
diff changeset
58 distribution with Vim.
1c039023af1c commit https://github.com/vim/vim/commit/b58988b832b69b52dfefeca338ea4802d0c4cdca
Christian Brabandt <cb@256bit.org>
parents: 7076
diff changeset
59
33760
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
60 If the maintainer does not respond, contact the [vim-dev][0] mailing list.
14347
723487cd7876 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 7084
diff changeset
61
35129
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
62 ## Contributing new runtime files
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
63
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
64 If you want to contribute new runtime files for Vim or Neovim, please create a
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
65 PR with your changes against this repository here. For new filetypes, do not forget:
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
66 * to add a new [filetype test][12] (keep it similar to the other filetype tests).
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
67 * all configuration switches should be documented
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
68 (check [filetype.txt][13] and/or [syntax.txt][14] for filetype and syntax plugins)
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
69 * add yourself as Maintainer to the top of file (again, keep the header similar to
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
70 other runtime files)
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
71 * add yourself to the [MAINTAINERS][11] file.
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
72
14347
723487cd7876 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 7084
diff changeset
73 # Translations
723487cd7876 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 7084
diff changeset
74
16285
e71261a88630 patch 8.1.1147: desktop file translations are requiring manual updates
Bram Moolenaar <Bram@vim.org>
parents: 16208
diff changeset
75 Translating messages and runtime files is very much appreciated! These things
e71261a88630 patch 8.1.1147: desktop file translations are requiring manual updates
Bram Moolenaar <Bram@vim.org>
parents: 16208
diff changeset
76 can be translated:
14372
2a4a2dc35c55 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14347
diff changeset
77 * Messages in Vim, see [src/po/README.txt][1]
16285
e71261a88630 patch 8.1.1147: desktop file translations are requiring manual updates
Bram Moolenaar <Bram@vim.org>
parents: 16208
diff changeset
78 Also used for the desktop icons.
14372
2a4a2dc35c55 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14347
diff changeset
79 * Menus, see [runtime/lang/README.txt][2]
2a4a2dc35c55 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14347
diff changeset
80 * Vim tutor, see [runtime/tutor/README.txt][3]
2a4a2dc35c55 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14347
diff changeset
81 * Manual pages, see [runtime/doc/\*.1][4] for examples
16285
e71261a88630 patch 8.1.1147: desktop file translations are requiring manual updates
Bram Moolenaar <Bram@vim.org>
parents: 16208
diff changeset
82 * Installer, see [nsis/lang/\*.nsi][5] for examples
14347
723487cd7876 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 7084
diff changeset
83
723487cd7876 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 7084
diff changeset
84 The help files can be translated and made available separately.
723487cd7876 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 7084
diff changeset
85 See https://www.vim.org/translations.php for examples.
14372
2a4a2dc35c55 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14347
diff changeset
86
33760
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
87 # How do I contribute to the project?
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
88
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
89 Please have a look at the following [discussion][6], which should give you some
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
90 ideas. Please also check the [develop.txt][7] helpfile for the recommended
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
91 style. Often it's also beneficial to check the surrounding code for the style
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
92 being used.
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
93
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
94 # I have a question
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
95
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
96 If you have some question on the style guide, please contact the [vim-dev][0]
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
97 mailing list. For other questions please use the [Vi Stack Exchange][8] website, the
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
98 [vim-use][9] mailing list or make use of the [discussion][10] feature here at github.
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
99
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
100 [todo list]: https://github.com/vim/vim/blob/master/runtime/doc/todo.txt
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
101 [0]: http://www.vim.org/maillist.php#vim-dev
14372
2a4a2dc35c55 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14347
diff changeset
102 [1]: https://github.com/vim/vim/blob/master/src/po/README.txt
2a4a2dc35c55 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14347
diff changeset
103 [2]: https://github.com/vim/vim/blob/master/runtime/lang/README.txt
2a4a2dc35c55 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14347
diff changeset
104 [3]: https://github.com/vim/vim/blob/master/runtime/tutor/README.txt
2a4a2dc35c55 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 14347
diff changeset
105 [4]: https://github.com/vim/vim/blob/master/runtime/doc/vim.1
16285
e71261a88630 patch 8.1.1147: desktop file translations are requiring manual updates
Bram Moolenaar <Bram@vim.org>
parents: 16208
diff changeset
106 [5]: https://github.com/vim/vim/blob/master/nsis/lang/english.nsi
33760
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
107 [6]: https://github.com/vim/vim/discussions/13087
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
108 [7]: https://github.com/vim/vim/blob/master/runtime/doc/develop.txt
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
109 [8]: https://vi.stackexchange.com
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
110 [9]: http://www.vim.org/maillist.php#vim-use
c97e9e2d79a4 Improve CONTRIBUTING.md
Christian Brabandt <cb@256bit.org>
parents: 29533
diff changeset
111 [10]: https://github.com/vim/vim/discussions
35129
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
112 [11]: https://github.com/vim/vim/blob/master/.github/MAINTAINERS
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
113 [12]: https://github.com/vim/vim/blob/master/src/testdir/test_filetype.vim
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
114 [13]: https://github.com/vim/vim/blob/master/runtime/doc/filetype.txt
be122dc08867 The CODEOWNERS File is not useful
Christian Brabandt <cb@256bit.org>
parents: 33760
diff changeset
115 [14]: https://github.com/vim/vim/blob/master/runtime/doc/syntax.txt