diff options
author | TheArcaneBrony <myrainbowdash949@gmail.com> | 2023-09-15 10:11:20 +0200 |
---|---|---|
committer | TheArcaneBrony <myrainbowdash949@gmail.com> | 2023-09-15 10:11:20 +0200 |
commit | c162334a1b80004a3dccc3b7579f26df15eb4874 (patch) | |
tree | b98f50ff90a0d86d8fcdf8410a84da2be0b6d398 | |
parent | Some refactoring (diff) | |
download | LibMatrix-c162334a1b80004a3dccc3b7579f26df15eb4874.tar.xz |
Add README
Diffstat (limited to '')
-rw-r--r-- | README.MD | 39 |
1 files changed, 39 insertions, 0 deletions
diff --git a/README.MD b/README.MD new file mode 100644 index 0000000..9f67ba6 --- /dev/null +++ b/README.MD @@ -0,0 +1,39 @@ +# Rory&::LibMatrix + +An extensible C# library for the Matrix protocol. Primarily built around our own project needs, but we're open to contributions and improvements, especially around spec compliance. +The library primarily targets .NET 7, but will update to .NET 8 once that's released. Preferably, we like to follow the latest release of .NET. + +# Installation + +Probably add as a submodule for now? NuGet packaging still has to be implemented. + +# 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 +``` |