Add CONTRIBUTING.md

This commit is contained in:
silverpill 2022-10-30 21:47:45 +00:00
parent f31f9ecd96
commit 8a3c3fdec2
No known key found for this signature in database
GPG key ID: 955F5A6E212325F0
2 changed files with 36 additions and 0 deletions

34
CONTRIBUTING.md Normal file
View file

@ -0,0 +1,34 @@
# Contributing
## General
Mitra is developed according to these principles:
- Resilience. The primary function of Mitra is delivery of messages from publisher to the audience. It should be able to perform this task even in adversarial conditions.
- Self-hosting. If some feature depends on other service (such as blockchain node), that service must be free / open source software and it must be able to run on affordable hardware. No dependecies on proprietary services allowed.
- Low system requirements. The default configuration should work smoothly on a low-end VPS.
- Privacy. In its default configuration, Mitra shouldn't require any personal info (other than username / public key) or collect usage statistics. It also shouldn't reveal more information about the user then necessary.
## Before you start
If you want to propose a change, please create an [issue](https://codeberg.org/silverpill/mitra/issues) first and explain what you want to do (unless it's something trivial).
## Code
Simplicity is more important than minor performance improvements.
Avoid advanced language features unless there's a good reason to use them. The code should be comprehensible even to a Rust beginner.
### Dependencies
Try to minimize the number of dependencies.
Prefer libraries maintained by volunteers over those developed by for-profit companies.
### Code style
Run `cargo clippy` to check code automatically. Try to follow the existing style when adding new features.
### Commits
Commits should be atomic (the tests should pass) and not too big. Commit messages should be informative.

View file

@ -119,6 +119,8 @@ Add blockchain configuration to `blockchains` array in your configuration file.
## Development
See [CONTRIBUTING.md](./CONTRIBUTING.md)
### Start database server
```