mirror of
https://oauth2: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@github.com/m1ngsama/chopsticks.git
synced 2026-05-10 19:10:59 +08:00
m1ngsama
7b4b153f4b
Add centered hero layout with demo GIF, 5 shields.io badges, collapsible keybindings, performance table, and architecture tree. Add GitHub Actions CI (startup test + shellcheck), issue/PR templates, CONTRIBUTING.md, and VHS demo recording.
30 lines
1.1 KiB
Markdown
30 lines
1.1 KiB
Markdown
# Contributing
|
|
|
|
## Rules
|
|
|
|
1. **No Node.js dependencies.** The LSP engine is pure VimScript. Some language servers need Node — that's fine. The config itself must not.
|
|
2. **Startup matters.** Run `vim --startuptime /tmp/s.log -c qa!` before and after. If your change adds >1ms, it needs a good reason.
|
|
3. **Works on TTY.** Test over SSH. If it breaks in a terminal without true color, fix it or gate it behind `g:is_tty`.
|
|
4. **One module, one concern.** Don't put git config in lsp.vim.
|
|
|
|
## Adding a plugin
|
|
|
|
1. Add the `Plug` line to `modules/plugins.vim`
|
|
2. If it's not needed at startup, lazy-load it: `Plug 'foo/bar', { 'on': 'FooCommand' }`
|
|
3. Put config in the appropriate module
|
|
4. Update the cheat sheet in `modules/tools.vim` if you add keybindings
|
|
5. Test on both macOS and Linux
|
|
|
|
## Reporting bugs
|
|
|
|
Open an issue. Include:
|
|
- OS and Vim version
|
|
- Whether you're on SSH/TTY
|
|
- Steps to reproduce
|
|
|
|
## Code style
|
|
|
|
- Named augroups with `autocmd!`
|
|
- No comments explaining *what* — only *why*
|
|
- `exists('g:plugs["..."]')` guards for plugin-dependent config
|
|
- Test with `vim -u .vimrc --startuptime /tmp/s.log -c qa!`
|