diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-05-06 02:44:24 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-05-06 02:44:24 +0000 |
commit | 8baab3c8d7a6f22888bd581cd5c6098fd2e4b5a8 (patch) | |
tree | 3537e168b860f2742f6029d70501b5ed7d15d345 /CONTRIBUTING.md | |
parent | Initial commit. (diff) | |
download | vim-8baab3c8d7a6f22888bd581cd5c6098fd2e4b5a8.tar.xz vim-8baab3c8d7a6f22888bd581cd5c6098fd2e4b5a8.zip |
Adding upstream version 2:8.1.0875.upstream/2%8.1.0875upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'CONTRIBUTING.md')
-rw-r--r-- | CONTRIBUTING.md | 74 |
1 files changed, 74 insertions, 0 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..d94e92a --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,74 @@ +# Contributing to Vim + +Patches are welcome in whatever form. +Discussions about patches happen on the vim-dev maillist. +If you create a pull request on GitHub it will be +forwarded to the vim-dev maillist. You can also send your patch there +directly. An attachment with a unified diff format is preferred. +Information about the maillist can be found [on the Vim website]. + +[on the Vim website]: http://www.vim.org/maillist.php#vim-dev + +Please consider adding a test. Test coverage isn't very good yet, this needs +to improve. Look through recent patches for examples. The tests are located +under "src/testdir". + + +# Reporting issues + +We use GitHub issues, but that is not a requirement. Writing to the Vim +maillist is also fine. + +Please use the GitHub issues only for actual issues. If you are not 100% sure +that your problem is a Vim issue, please first discuss this on the Vim user +maillist. Try reproducing the problem without any plugins or settings: + + vim -N -u NONE + +If you report an issue, please describe exactly how to reproduce it. +For example, don't say "insert some text" but say what you did exactly: +"ahere is some text<Esc>". +Ideally, the steps you list can be used to write a test to verify the problem +is fixed. + +Feel free to report even the smallest problem, also typos in the documentation. + +You can find known issues in the todo file: ":help todo". +Or open [the todo file] on GitHub to see the latest version. + +[the todo file]: https://github.com/vim/vim/blob/master/runtime/doc/todo.txt + + +# Syntax, indent and other runtime files + +The latest version of these files can be obtained from the repository. +They are usually not updated with numbered patches. + +If you find a problem with one of these files or have a suggestion for +improvement, please first try to contact the maintainer directly. +Look in the header of the file for the name and email address. + +The maintainer will take care of issues and send updates to Bram for +distribution with Vim. + +If the maintainer does not respond, contact the vim-dev maillist. + + +# Translations + +Translating messages and runtime files is very much appreciated! These things can be translated: +* Messages in Vim, see [src/po/README.txt][1] +* Menus, see [runtime/lang/README.txt][2] +* Vim tutor, see [runtime/tutor/README.txt][3] +* Manual pages, see [runtime/doc/\*.1][4] for examples +* Desktop icon, see [runtime/vim.desktop][5] and [runtime/gvim.desktop][6] + +The help files can be translated and made available separately. +See https://www.vim.org/translations.php for examples. + +[1]: https://github.com/vim/vim/blob/master/src/po/README.txt +[2]: https://github.com/vim/vim/blob/master/runtime/lang/README.txt +[3]: https://github.com/vim/vim/blob/master/runtime/tutor/README.txt +[4]: https://github.com/vim/vim/blob/master/runtime/doc/vim.1 +[5]: https://github.com/vim/vim/blob/master/runtime/vim.desktop +[6]: https://github.com/vim/vim/blob/master/runtime/gvim.desktop |