TheArchive/session-android
1
0
Fork 0
mirror of https://github.com/oxen-io/session-android.git synced 2024-11-25 02:55:23 +00:00
Code Issues Packages Projects Releases Wiki Activity
5ca8a6d421
session-android/contributing.md
Jake McGinty 622d8975fc add section about submitting useful bug reports
2014-06-20 12:24:36 -07:00

1.5 KiB
Raw Blame History

##Translations

Please do not submit issues or pull requests for translation fixes. Anyone can update the translations in Transifex. Please submit your corrections there.

Submitting useful bug reports

  1. Search our issues first to make sure this is not a duplicate.
  2. Read the Submitting useful bug reports guide before posting a bug.

Development Ideology

Truths which we believe to be self-evident:

  1. The answer is not more options. If you feel compelled to add a preference that's exposed to the user, it's very possible you've made a wrong turn somewhere.
  2. The user doesn't know what a key is. We need to minimize the points at which a user is exposed to this sort of terminology as extremely as possible.
  3. There are no power users. The idea that some users "understand" concepts better than others has proven to be, for the most part, false. If anything, "power users" are more dangerous than the rest, and we should avoid exposing dangerous functionality to them.
  4. If it's "like PGP," it's wrong. PGP is our spirit guide for what not to do.
  5. It's an asynchronous world. Be wary of anything that is anti-asynchronous: ACKs, protocol confirmations, or any protocol-level "advisory" message.
  6. There is no such thing as time. Protocol ideas that require synchronized clocks are doomed to failure.