File tree Expand file tree Collapse file tree 2 files changed +43
-0
lines changed
Expand file tree Collapse file tree 2 files changed +43
-0
lines changed Original file line number Diff line number Diff line change 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.
Original file line number Diff line number Diff line change @@ -23,6 +23,9 @@ guidance can be found [here](https://mechvibes-lite.pages.dev/configuration/).
2323You 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```
2831Usage: mvibes [OPTIONS] COMMAND [ARGS]...
You can’t perform that action at this time.
0 commit comments