docs: updates

Author: Zhe Yu

README.md

@@ -51,6 +51,9 @@ model output and reduce hallucination.
     instructions to setup VectorCode to work with some other neovim plugins;
   - the [discussions](https://github.com/Davidyz/VectorCode/discussions) where
     you can ask general questions and share your cool usages about VectorCode.
+  - If you're feeling adanvturous, feel free to check out 
+    [the pull requests](https://github.com/Davidyz/VectorCode/pulls) for
+    WIP features.
 
 If you're trying to contribute to this project, take a look at [the contribution
 guide](./docs/CONTRIBUTING.md), which contains information about some basic

docs/CONTRIBUTING.md

@@ -1,3 +1,13 @@
+# Before You Start
+
+As much as I appreciate everyone who wish to contribute to this project, if
+you want to submit a new feature/refactoring that is more than a few lines,
+it'll be better if you open an issue or discussion before you start working.
+This allows us to thoroughly exchange ideas before people invest too much time,
+and will help me maintain the codebase in the long run.
+
+# Technical Stuff
+
 This project uses [pre-commit](https://pre-commit.com/) to perform some
 formatting and linting. If you're
 contributing to this project, having it on your system will help you write code
@@ -6,7 +16,7 @@ You can also see
 [.pre-commit-config.yaml](https://github.com/Davidyz/VectorCode/blob/main/.pre-commit-config.yaml) 
 for a list of hooks enabled for the repo.
 
-# Python CLI
+## Python CLI
 
 The development and publication of this tool is managed by 
 [pdm](https://pdm-project.org/en/latest/).
@@ -30,7 +40,7 @@ You may also find it helpful to
 [enable logging](https://github.com/Davidyz/VectorCode/blob/main/docs/cli.md#debugging-and-diagnosing) 
 for the CLI when developing new features or working on fixes.
 
-# Neovim Plugin
+## Neovim Plugin
 
 At the moment, there isn't much to cover on here. As long as the code is 
 formatted (stylua) and appropriately type-annotated, you're good. I do have 

docs/cli.md

@@ -407,7 +407,12 @@ specs will be vectorised when you run `vectorcode vectorise` without specifying
 files. This file has lower priority than `.gitignore`, but you can override this
 by the `-f` flag. It also doesn't assume `--recursive`, so if you want to add a
 whole directory to this file, you can use `dir/**`, which matches all content
-of `dir/` recursively.
+of `dir/` recursively. 
+
+> Note that the `include` spec only kicks in when you don't
+supply file paths when calling `vectorcode vectorise`. If you want a rule to be
+effective _whenever you vectorise some files_, you should use the `exclude`
+specs explained below.
 
 Similarly, you can also create a `project_root/.vectorcode/vectorcode.exclude`
 file to denote any files that you want to exclude. This is useful when you have