about summary refs log tree commit diff
path: root/CONTRIBUTING.MD
diff options
context:
space:
mode:
authorRory& <root@rory.gay>2025-11-07 22:36:50 +0100
committerRory& <root@rory.gay>2025-11-07 22:36:50 +0100
commit2cd76f916a13e66f1fdf06dd7bf5dff6be64de0b (patch)
tree74be7cbf4cbfb7749ede5325bce1f92728ece648 /CONTRIBUTING.MD
parentRemove deprecated unauthenticated media uris (diff)
downloadLibMatrix-2cd76f916a13e66f1fdf06dd7bf5dff6be64de0b.tar.xz
WIP: nix CI
Diffstat (limited to 'CONTRIBUTING.MD')
-rw-r--r--CONTRIBUTING.MD30
1 files changed, 30 insertions, 0 deletions
diff --git a/CONTRIBUTING.MD b/CONTRIBUTING.MD
new file mode 100644

index 0000000..8c305b7 --- /dev/null +++ b/CONTRIBUTING.MD
@@ -0,0 +1,30 @@ +# Contributing + +Any contribution is welcome, even if it's just documentation or recommended git practices! We're not too strict on code style, but we do have a few guidelines: +- Use spaces, not tabs +- Use 4 spaces for indentation +- Use the C# naming convention for variables, methods, etc. +- Wrap lines at 160 characters, though this value can be changed if it's too lean or strict +- Use the `#region` and `#endregion` directives to group code if you're adding utility functions + +```sh +# Prepare patch set +mkdir patches +git format-patch --output-directory "./patches" @{u}.. + +# Send patches +... +``` +You can send the patches to [@emma:rory.gay](https://matrix.to/#/@emma:rory.gay) or in the [Rory&::LibMatrix room](https://matrix.to/#/#libmatrix:rory.gay). + +### Developer utility commands + +Error reporting upon file save (may not work): +```sh +inotifywait -rmqe CLOSE_WRITE --include '.*\.cs$' . | while read l; do clear; dotnet build --property WarningLevel=0; done +``` + +Hot rebuild on file save: +```sh +dotnet watch run --no-hot-reload --property WarningLevel=0 +```