JIe
2bb7059579
Some checks failed
Detach Plugins / check (FlyGrep.vim) (push) Has been cancelled
Detach Plugins / check (GitHub.vim) (push) Has been cancelled
Detach Plugins / check (JavaUnit.vim) (push) Has been cancelled
Detach Plugins / check (SourceCounter.vim) (push) Has been cancelled
Detach Plugins / check (cpicker.nvim) (push) Has been cancelled
Detach Plugins / check (dein-ui.vim) (push) Has been cancelled
Detach Plugins / check (git.vim) (push) Has been cancelled
Detach Plugins / check (iedit.vim) (push) Has been cancelled
Detach Plugins / check (scrollbar.vim) (push) Has been cancelled
Detach Plugins / check (vim-chat) (push) Has been cancelled
Detach Plugins / check (vim-cheat) (push) Has been cancelled
Detach Plugins / check (vim-todo) (push) Has been cancelled
Detach Plugins / check (xmake.vim) (push) Has been cancelled
test / Linux (nvim, nightly) (push) Has been cancelled
test / Linux (nvim, v0.3.8) (push) Has been cancelled
test / Linux (nvim, v0.4.0) (push) Has been cancelled
test / Linux (nvim, v0.4.2) (push) Has been cancelled
test / Linux (nvim, v0.4.3) (push) Has been cancelled
test / Linux (nvim, v0.4.4) (push) Has been cancelled
test / Linux (nvim, v0.5.0) (push) Has been cancelled
test / Linux (nvim, v0.5.1) (push) Has been cancelled
test / Linux (nvim, v0.6.0) (push) Has been cancelled
test / Linux (nvim, v0.6.1) (push) Has been cancelled
test / Linux (nvim, v0.7.0) (push) Has been cancelled
test / Linux (nvim, v0.7.2) (push) Has been cancelled
test / Linux (nvim, v0.8.0) (push) Has been cancelled
test / Linux (nvim, v0.8.1) (push) Has been cancelled
test / Linux (nvim, v0.8.2) (push) Has been cancelled
test / Linux (nvim, v0.8.3) (push) Has been cancelled
test / Linux (nvim, v0.9.0) (push) Has been cancelled
test / Linux (nvim, v0.9.1) (push) Has been cancelled
test / Linux (true, vim, v7.4.052) (push) Has been cancelled
test / Linux (true, vim, v7.4.1689) (push) Has been cancelled
test / Linux (true, vim, v7.4.629) (push) Has been cancelled
test / Linux (true, vim, v8.0.0027) (push) Has been cancelled
test / Linux (true, vim, v8.0.0183) (push) Has been cancelled
test / Linux (vim, nightly) (push) Has been cancelled
test / Linux (vim, v8.0.0184) (push) Has been cancelled
test / Linux (vim, v8.0.1453) (push) Has been cancelled
test / Linux (vim, v8.1.2269) (push) Has been cancelled
test / Linux (vim, v8.2.2434) (push) Has been cancelled
test / Linux (vim, v8.2.3995) (push) Has been cancelled
test / Windows (nvim, nightly) (push) Has been cancelled
test / Windows (nvim, v0.3.8) (push) Has been cancelled
test / Windows (nvim, v0.4.2) (push) Has been cancelled
test / Windows (nvim, v0.4.3) (push) Has been cancelled
test / Windows (nvim, v0.4.4) (push) Has been cancelled
test / Windows (nvim, v0.5.0) (push) Has been cancelled
test / Windows (nvim, v0.5.1) (push) Has been cancelled
test / Windows (nvim, v0.6.0) (push) Has been cancelled
test / Windows (nvim, v0.6.1) (push) Has been cancelled
test / Windows (nvim, v0.7.0) (push) Has been cancelled
test / Windows (nvim, v0.7.2) (push) Has been cancelled
test / Windows (nvim, v0.8.0) (push) Has been cancelled
test / Windows (nvim, v0.8.1) (push) Has been cancelled
test / Windows (nvim, v0.8.2) (push) Has been cancelled
test / Windows (nvim, v0.8.3) (push) Has been cancelled
test / Windows (nvim, v0.9.0) (push) Has been cancelled
test / Windows (nvim, v0.9.1) (push) Has been cancelled
test / Windows (vim, nightly) (push) Has been cancelled
test / Windows (vim, v7.4.1185) (push) Has been cancelled
test / Windows (vim, v7.4.1689) (push) Has been cancelled
test / Windows (vim, v8.0.0027) (push) Has been cancelled
test / Windows (vim, v8.0.1453) (push) Has been cancelled
test / Windows (vim, v8.1.2269) (push) Has been cancelled
test / Windows (vim, v8.2.2434) (push) Has been cancelled
test / Windows (vim, v8.2.3995) (push) Has been cancelled
docker / docker (push) Has been cancelled
mirror / check (coding) (push) Has been cancelled
mirror / check (gitee) (push) Has been cancelled
mirror / check (gitlab) (push) Has been cancelled
58 lines
2.1 KiB
Markdown
58 lines
2.1 KiB
Markdown
# Issue descriptions
|
|
|
|
Please see the [issue template](ISSUE_TEMPLATE.md) for how to write a good
|
|
issue description. In short, it should contain the following:
|
|
|
|
1. Describe the issue in detail, include steps to reproduce the issue
|
|
2. Include a minimal working example
|
|
3. Include a minimal vimrc file
|
|
|
|
# Guide for code contributions
|
|
|
|
## Branch model
|
|
|
|
match-up is developed mainly through the master branch, and pull requests should
|
|
be [fork based](https://help.github.com/articles/using-pull-requests/).
|
|
|
|
## Documentation style
|
|
|
|
Vim help files have their own specific syntax. There is a Vim help section on
|
|
how to write them, see [`:h
|
|
help-writing`](http://vimdoc.sourceforge.net/htmldoc/helphelp.html#help-writing).
|
|
|
|
The match-up documentation style should be relatively clear, and it should be
|
|
easy to see from the existing documentation how to write it. Still, here are
|
|
some pointers:
|
|
|
|
- Max 80 columns per line
|
|
- Use the help tag system for pointers to other parts of the Vim documentation
|
|
- Use line of `=`s to separate sections
|
|
- Use line of `-`s to separate subsections
|
|
- The section tags should be right aligned at the 79th column
|
|
- Sections should be included and linked to from the table of contents
|
|
|
|
## Code style
|
|
|
|
When submitting code for match-up, please adhere to the following standards:
|
|
|
|
- Use `shiftwidth=2` - no tabs!
|
|
- Write readable code
|
|
- Break lines for readability
|
|
- Line should not be longer than 74 columns
|
|
- Use comments:
|
|
- For complex code that is difficult to understand
|
|
- Simple code does not need comments
|
|
- Use (single) empty lines to separate logical blocks of code
|
|
- Use good variable names
|
|
- The name should indicate what the variable is/does
|
|
- Variable names should be lower case
|
|
- Local function variables should be preceded with `l:`
|
|
- Prefer single quoted strings
|
|
- See also the [Google vimscript style
|
|
guide](https://google.github.io/styleguide/vimscriptguide.xml)
|
|
- Use markers for folding
|
|
- I generally only fold functions, and I tend to group similar functions so
|
|
that when folded, I get a nice structural overview of a file
|
|
- See some of the files for examples of how I do this
|
|
|