|
| 1 | +# Contributing |
| 2 | + |
| 3 | +Thanks for contributing to `remote-nvim.nvim`. Your help means a lot! |
| 4 | + |
| 5 | +You can make contributions in the following ways: |
| 6 | + |
| 7 | +- **Mention it** to others if it has helped enhance/improve your workflow. |
| 8 | +- **Create GitHub issues** so that we know what we should work on building/fixing next. |
| 9 | +- **Raise PR** to fix bugs, improve documentation, add features, etc. The list goes on. |
| 10 | +- **Participate** in issues and discussions. |
| 11 | + |
| 12 | +## Getting started |
| 13 | + |
| 14 | +If you are setting the repo up, run `make install-hooks` to install the pre-commit hooks. These hooks should take care |
| 15 | +of most meta-things needed. Please make sure that the pre-commit checks and tests pass before raising the PR. In case, |
| 16 | +something is unclear, please raise the PR and we can take care of it then! |
| 17 | + |
| 18 | +### Pre-requisites |
| 19 | + |
| 20 | +- LuaLS (LSP server) |
| 21 | +- [lazydev.nvim](https://github.com/folke/lazydev.nvim/) |
| 22 | +- pre-commit |
| 23 | + |
| 24 | +Steps: |
| 25 | + |
| 26 | +1. Run `make install-hooks`: Installs all necessary pre-commit hooks. Post setup, it should take care of all meta-things |
| 27 | + like formatting, linting, etc. |
| 28 | +2. Setup [lazydev.nvim](https://github.com/folke/lazydev.nvim/). If this is not your thing, setup |
| 29 | + [.luarc.json](https://github.com/amitds1997/remote-nvim.nvim/blob/2d5158a/.luarc.json) file at the root |
| 30 | + of the project. |
| 31 | + |
| 32 | +Once setup, make your changes! |
| 33 | + |
| 34 | +### Testing |
| 35 | + |
| 36 | +If you make any code changes, please add relevant test(s) post that. Once done, |
| 37 | +run `make clean-test` to run the tests. Make sure that the tests pass before creating the PR. |
| 38 | + |
| 39 | +### Commit message guidelines |
| 40 | + |
| 41 | +- For any features, bugs, etc. please use conventional commit message format. This helps in |
| 42 | + automatic changelog generations. |
| 43 | +- For any minor changes that is not code related, it is OK if you do not use conventional commits. |
| 44 | + |
| 45 | +### Other information |
| 46 | + |
| 47 | +- Help file is generated from the README (which is not an ideal solution, but it helps reduce the workload). So, |
| 48 | + update the README, if documentation needs to be updated. |
| 49 | + |
| 50 | +## Credits |
| 51 | + |
| 52 | +This documentation is heavily plaguarized from the `mini.nvim` CONTRIBUTING.md. So, thanks! |
0 commit comments