The CODEOWNERS File is not useful Commit: https://github.com/vim/vim/commit/3ac83c7141dd60ae45c0346b7c0f4539587391aa Author: Christian Brabandt <c...@256bit.org> Date: Wed May 8 19:39:54 2024 +0200
The CODEOWNERS File is not useful Github is complaining about "This file has errors" and is just noisy and for that reason does not ping maintainers if a new issue/PR is created. Let's just rename it to MAINTAINERS file instead and update the documentation. Signed-off-by: Christian Brabandt <c...@256bit.org> diff --git a/.github/CODEOWNERS b/.github/MAINTAINERS similarity index 100% rename from .github/CODEOWNERS rename to .github/MAINTAINERS diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 0720cb169..99bfcfa2c 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -46,17 +46,30 @@ Or open [the todo file][todo list] on GitHub to see the latest version. # 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. +They are usually not updated with numbered patches. However, they may +or may not work with older Vim releases (since they may contain new features). 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. +Look in the header of the file for the name, email address, github handle and/or +upstream repository. You may also check the [MAINTAINERS][11] file. The maintainer will take care of issues and send updates to the Vim project for distribution with Vim. If the maintainer does not respond, contact the [vim-dev][0] mailing list. +## Contributing new runtime files + +If you want to contribute new runtime files for Vim or Neovim, please create a +PR with your changes against this repository here. For new filetypes, do not forget: +* to add a new [filetype test][12] (keep it similar to the other filetype tests). +* all configuration switches should be documented + (check [filetype.txt][13] and/or [syntax.txt][14] for filetype and syntax plugins) +* add yourself as Maintainer to the top of file (again, keep the header similar to + other runtime files) +* add yourself to the [MAINTAINERS][11] file. + # Translations Translating messages and runtime files is very much appreciated! These things @@ -96,3 +109,7 @@ mailing list. For other questions please use the [Vi Stack Exchange][8] website, [8]: https://vi.stackexchange.com [9]: http://www.vim.org/maillist.php#vim-use [10]: https://github.com/vim/vim/discussions +[11]: https://github.com/vim/vim/blob/master/.github/MAINTAINERS +[12]: https://github.com/vim/vim/blob/master/src/testdir/test_filetype.vim +[13]: https://github.com/vim/vim/blob/master/runtime/doc/filetype.txt +[14]: https://github.com/vim/vim/blob/master/runtime/doc/syntax.txt diff --git a/Filelist b/Filelist index ff474bc64..771854812 100644 --- a/Filelist +++ b/Filelist @@ -5,7 +5,7 @@ SRC_ALL = \ .cirrus.yml \ .gitattributes \ - .github/CODEOWNERS \ + .github/MAINTAINERS \ .github/ISSUE_TEMPLATE/bug_report.yml \ .github/ISSUE_TEMPLATE/feature_request.md \ .github/workflows/ci.yml \ -- -- You received this message from the "vim_dev" maillist. Do not top-post! Type your reply below the text you are replying to. For more information, visit http://www.vim.org/maillist.php --- You received this message because you are subscribed to the Google Groups "vim_dev" group. To unsubscribe from this group and stop receiving emails from it, send an email to vim_dev+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/vim_dev/E1s4lLj-006TOg-6o%40256bit.org.