Skip to content

Commit 5bfd583

Browse files
committed
feat(readme): add files and docs for contributing to the project
1 parent 08e9033 commit 5bfd583

File tree

2 files changed

+43
-0
lines changed

2 files changed

+43
-0
lines changed

CONTRIBUTING.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# Contributing
2+
We use [uv](https://docs.astral.sh/uv/) to manage this Python package.
3+
4+
## Install Development Dependencies
5+
```console
6+
user:~$ uv sync --extra dev
7+
```
8+
9+
`uv` will create a virtual environment for you under `.venv/` in the
10+
source tree, by default. It has been ignored in the `.gitignore` and `.dockerignore` files
11+
for you already. Also see [Development Shell](#development-shell).
12+
13+
## Editing/Expanding Documentation
14+
Serve the documentation by doing:
15+
```console
16+
user:~$ uv run mkdocs serve
17+
```
18+
19+
Then go to the address that it is serving on. It should reload the page
20+
automatically on any change under `/docs` folder in the source tree.
21+
22+
> [!NOTE]
23+
> You need to sync with the `dev` dependency group before attempting
24+
> this as shown [here](#install-development-dependencies).
25+
26+
## Running the Package
27+
```console
28+
user:~$ uv run mvibes --help
29+
```
30+
31+
## Development Shell
32+
You can do `uv run <shell-executable-here>` to open a shell with the right
33+
environment setup. Examples:
34+
* `uv run powershell`
35+
* `uv run cmd`
36+
* `uv run bash`
37+
* `uv run fish`
38+
39+
In that shell, you should have the right `mvibes` and `mkdocs` executables from
40+
the `.venv/bin` folder.

README.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,9 @@ guidance can be found [here](https://mechvibes-lite.pages.dev/configuration/).
2323
You can learn how to use this software
2424
[here](https://mechvibes-lite.pages.dev/usage/).
2525

26+
# Contributing
27+
See [`CONTRIBUTING.md`](CONTRIBUTING.md). Thank you.
28+
2629
# Command-line Arguments
2730
```
2831
Usage: mvibes [OPTIONS] COMMAND [ARGS]...

0 commit comments

Comments
 (0)