From 538833b0d4e81be3b9fd86e64a0b6161d3db4950 Mon Sep 17 00:00:00 2001 From: Julio Castillo Date: Mon, 3 Apr 2023 11:56:44 +0200 Subject: [PATCH] Update CONTRIBUTING.md --- CONTRIBUTING.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 050257e7..b0be2797 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -200,6 +200,10 @@ We have several such interfaces defined for IAM, log sinks, organizational polic #### Design interfaces to support actual usage +> “When developing a module, look for opportunities to take a little bit of extra suffering upon yourself in order to reduce the suffering of your users.” +> +> -- John Ousterhout in "A Philosophy of Software Design" + Variables should not simply map to the underlying resource attributes, but their **interfaces should be designed to match common use cases** to reduce friction and offer the highest possible degree of legibility. This translates into different practical approaches: