gitsigns.nvim/CONTRIBUTING.md

28 lines
853 B
Markdown
Raw Permalink Normal View History

2021-06-07 03:33:39 +08:00
## Requirements
- [Luarocks](https://luarocks.org/)
- `brew install luarocks`
## Generating docs
2023-06-11 00:15:48 +08:00
Most of the documentation is handwritten however the documentation for the configuration is generated from `lua/gitsigns/config.lua` which contains the configuration schema.
2021-06-07 03:33:39 +08:00
The documentation is generated with the lua script `gen_help.lua` which has been developed just enough to handle the current configuration schema so from time to time this script might need small improvements to handle new features but for the most part it works.
The documentation can be updated with:
2023-07-13 17:14:08 +08:00
```bash
2021-06-07 03:33:39 +08:00
make gen_help
```
## Testsuite
The testsuite uses the same framework as Neovims funcitonaltest suite.
This is just busted with lots of helper code to create headless neovim instances which are controlled via RPC.
To run the testsuite:
2023-07-13 17:14:08 +08:00
```bash
2021-06-07 03:33:39 +08:00
make test
```
2023-07-13 17:14:08 +08:00