Skip to content

Commit be94725

Browse files
committed
docs: update the suggested plugin config in CONTRIBUTING.md
1 parent eb2b5fc commit be94725

File tree

1 file changed

+22
-33
lines changed

1 file changed

+22
-33
lines changed

CONTRIBUTING.md

Lines changed: 22 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Contributing to codecompanion.nvim
1+
# Contributing to CodeCompanion.nvim
22

33
Thank you for considering contributing to CodeCompanion.nvim! This document provides guidelines and information to help you get started with contributing to the project.
44

@@ -38,44 +38,34 @@ CodeCompanion.nvim is organized into several key directories:
3838
### Prerequisites
3939

4040
- Neovim 0.10.0+
41-
- [lua-language-server](https://github.com/LuaLS/lua-language-server) for LSP support
41+
- [lua-language-server](https://github.com/LuaLS/lua-language-server) for LSP support and type annotations
4242
- [stylua](https://github.com/JohnnyMorganz/StyLua) for Lua formatting
4343

4444
### Setting Up for Development
4545

46-
1. Clone your fork of the repository
47-
2. Create a minimal configuration for testing:
46+
> This section explain how to setup the environment for development using lazy.nvim package manager. However you can use the package manager of your choice.
47+
48+
1. Clone your fork of the repository.
49+
2. Define codecompanion configuration pointing to your local repository:
4850

4951
```lua
50-
-- minimal.lua
51-
vim.env.LAZY_STDPATH = ".repro"
52-
load(vim.fn.system("curl -s https://raw.githubusercontent.com/folke/lazy.nvim/main/bootstrap.lua"))()
53-
54-
local plugins = {
55-
{
56-
"your_username/codecompanion.nvim",
57-
dev = true,
58-
dependencies = {
59-
{ "nvim-treesitter/nvim-treesitter", build = ":TSUpdate" },
60-
{ "nvim-lua/plenary.nvim" },
61-
-- Include any optional dependencies needed for your development
62-
},
63-
config = function()
64-
require("codecompanion").setup({
65-
opts = {
66-
log_level = "DEBUG", -- For development
67-
},
68-
-- Your test configuration here
69-
})
70-
end,
52+
{
53+
dir = "/full/path/to/local/codecompanion.nvim",
54+
dev = true,
55+
dependencies = {
56+
{ "nvim-treesitter/nvim-treesitter", build = ":TSUpdate" },
57+
{ "nvim-lua/plenary.nvim" },
58+
-- Include any optional dependencies needed for your development
7159
},
60+
opts = {
61+
opts = {
62+
log_level = "DEBUG", -- For development
63+
},
64+
-- The rest of your configuration
65+
}
7266
}
73-
74-
require("lazy.minit").repro({ spec = plugins })
7567
```
7668

77-
3. Launch Neovim with your minimal config: `nvim --clean -u minimal.lua`
78-
7969
## Debugging and Logging
8070

8171
### Logging
@@ -115,8 +105,7 @@ When adding new features, please include tests in the appropriate test file unde
115105
- Use [stylua](https://github.com/JohnnyMorganz/StyLua) for formatting Lua code
116106
- Configuration is in `stylua.toml`
117107
- Run `make format` to format the code before submitting a PR
118-
- Type annotations are encouraged (see `lua/codecompanion/types.lua`)
119-
- Use meaningful docstrings for functions with the standard LuaDoc format
108+
- Type annotations are encouraged (see `lua/codecompanion/types.lua`) and [LuaCATS site](https://luals.github.io/wiki/annotations/)
120109

121110
## Building Documentation
122111

@@ -130,7 +119,7 @@ make docs # Generate plugin documentation
130119

131120
- **Feature Requests**: Please suggest new features, but note that only features that align with the maintainer's workflow may be accepted.
132121
- **Bug Fixes**: When submitting a PR for a bug, ensure you've first raised an issue that can be recreated.
133-
- **Responsibility**: If you add a feature, you are responsible for maintaining and bug fixing that feature going forward.
122+
- **Responsibility**: If you add a feature, you are responsible for maintaining and bug fixing that feature going forward. The maintainers may provide guidance and support, but ultimate responsibility lies with the contributor.
134123
- **Code Quality**: Strive to maintain high code quality with proper tests.
135124
- **Communication**: If you have questions, open an issue or reach out to the maintainers.
136125

@@ -151,4 +140,4 @@ When facing issues during development, try these steps:
151140
4. Reference any related issues in your PR description
152141
5. The PR should be based on a prior discussion unless it's a straightforward bug fix
153142

154-
Thank you for contributing to codecompanion.nvim!
143+
Thank you for contributing to CodeCompanion.nvim!

0 commit comments

Comments
 (0)