Skip to content

Commit 8203995

Browse files
committed
chore: add CONTRIBUTING.md
1 parent c4657f0 commit 8203995

File tree

2 files changed

+33
-1
lines changed

2 files changed

+33
-1
lines changed

README.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,10 @@ and chat plugin available on VSCode and JetBrain products.
5858
- For neovim users, after you've gone through the CLI documentation, please refer to
5959
[the neovim plugin documentation](./docs/neovim.md) for further instructions.
6060

61+
If you're trying to contribute to this project, take a look at [the contribution
62+
guide](./docs/CONTRIBUTING.md), which contains information about some basic
63+
guidelines that you should follow and tips that you may find helpful.
64+
6165
## TODOs
6266
- [x] query by ~file path~ excluded paths;
6367
- [x] chunking support;
@@ -78,7 +82,7 @@ and chat plugin available on VSCode and JetBrain products.
7882
**Implemented project-level `.vectorcode/` and `.git` as root anchor**
7983
- [ ] ability to view and delete files in a collection (atm you can only `drop`
8084
and `vectorise` again);
81-
- [x] joint search (kinda, using codecompanion.nvim).
85+
- [x] joint search (kinda, using codecompanion.nvim/MCP).
8286

8387
## Credit
8488

docs/CONTRIBUTING.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
This project uses [pre-commit](https://pre-commit.com/) to perform some
2+
formatting and linting that hasn't made its way into CI/CD. If you're
3+
contributing to this project, make sure you set it up before you make the commit.
4+
You can also see
5+
[.pre-commit-config.yaml](https://github.com/Davidyz/VectorCode/blob/main/.pre-commit-config.yaml)
6+
for a list of hooks enabled for the repo.
7+
8+
# Python CLI
9+
10+
The development and publication of this tool is managed by
11+
[pdm](https://pdm-project.org/en/latest/).
12+
13+
Once you've cloned and `cd`ed into the repo, run `make deps`. This will call
14+
some `pdm` commands to install development dependencies. Some of them are
15+
actually optional, but for convenience I decided to leave them here. This will
16+
include [pytest](https://docs.pytest.org/en/stable/), the testing framework,
17+
and [coverage.py](https://coverage.readthedocs.io/en/7.7.1/), the coverage
18+
report tool. If you're not familiar with pytest or coverage.py, you can run `make test` to
19+
run tests, and `make coverage` to generate a coverage report. The testing and
20+
coverage report are also in the CI configuration, but it might still help to run
21+
them locally before you open the PR.
22+
23+
# Neovim Plugin
24+
25+
At the moment, there isn't much to cover on here. As long as the code is
26+
formatted (stylua) and appropriately type-annotated, you're good. I do have
27+
plans to write some tests, but before that happens, formatting and type
28+
annotations are the only things that you need to take special care of.

0 commit comments

Comments
 (0)