2024-03-04 12:23:00 -05:00
|
|
|
# Contributing to Tilde Friends
|
2024-03-06 21:14:09 -05:00
|
|
|
|
2024-03-04 12:23:00 -05:00
|
|
|
Thank you for your interest in Tilde Friends.
|
|
|
|
|
2024-03-06 21:14:09 -05:00
|
|
|
Above all, Tilde Friends aims to be a fun, safe place to play. When that is at
|
2024-03-04 12:23:00 -05:00
|
|
|
odds with the course of development, we will work through it with respectful
|
|
|
|
communication.
|
|
|
|
|
|
|
|
## How can I contribute?
|
|
|
|
|
2024-03-06 21:14:09 -05:00
|
|
|
The nature of Tilde Friends makes for a wide range of ways to contribute
|
2024-03-04 12:23:00 -05:00
|
|
|
|
2024-03-06 21:14:09 -05:00
|
|
|
- Just use it. Really, just kicking the tires will probably shake out issues
|
|
|
|
in useful ways at this point.
|
|
|
|
- Report and comment on bugs: https://dev.tildefriends.net/issues.
|
|
|
|
- Make apps. You don't need my permission to make and share apps with Tilde
|
|
|
|
Friends. I hope that an ecosystem of good apps grows outside of this
|
|
|
|
repository. If you want to recreate better versions of the stock apps, just
|
|
|
|
do it. If you make a better ssb app or whatever and drop me a line however
|
|
|
|
is most convenient for you, I will probably take a look and consider
|
|
|
|
replacing the stock one with it.
|
|
|
|
- Write about it. Docs in the git repository, blog posts, private messages to
|
|
|
|
me with ideas...really there is no wrong answer. Just make some noise, and
|
|
|
|
I'll do my best to incorporate or otherwise link your feedback and make the
|
|
|
|
most of it.
|
|
|
|
- Write C code in the git repository. I'm really striving for it to be the
|
|
|
|
case that other people don't really need to meddle in there, but if you can
|
|
|
|
help out, I will gladly review your pull requests via
|
|
|
|
https://dev.tildefriends.net/pulls.
|
2024-03-04 12:23:00 -05:00
|
|
|
|
|
|
|
## Best practices
|
|
|
|
|
2024-03-06 21:14:09 -05:00
|
|
|
- The C code is formatted with clang-format. Run `make format`.
|
|
|
|
- The rest is formatted with prettier. Run `npm run prettier`.
|
|
|
|
- We strive to have code compile on all platforms with no warnings and run with
|
2024-03-04 12:23:00 -05:00
|
|
|
no sanitizer issues.
|
2024-03-06 21:14:09 -05:00
|
|
|
- There are tests. Run `out/debug/tildefriends test`.
|