From f190321e40bc727bcd2238dd8c720fe32e6ed635 Mon Sep 17 00:00:00 2001 From: Moxie Marlinspike Date: Sat, 31 May 2014 15:05:59 -0700 Subject: [PATCH] Add some ideology to contributing.md //FREEBIE --- contributing.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/contributing.md b/contributing.md index e79b45f056..a27bea0deb 100644 --- a/contributing.md +++ b/contributing.md @@ -1,3 +1,22 @@ ##Translations Please do not submit issues or pull requests for translation fixes. Anyone can update the translations in [Transifex](https://www.transifex.com/projects/p/textsecure-official/). Please submit your corrections there. + +## 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. +1. **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. +1. **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. +1. **It's an asynchronous world.** Be wary of anything that is + anti-asynchronous: ACKs, protocol confirmations, or any protocol-level + "advisory" message. +