]> git.sur5r.net Git - i3/i3.github.io/commitdiff
document values for considering contributions (#30)
authorMichael Stapelberg <stapelberg@users.noreply.github.com>
Mon, 6 Feb 2017 18:10:00 +0000 (10:10 -0800)
committerGitHub <noreply@github.com>
Mon, 6 Feb 2017 18:10:00 +0000 (10:10 -0800)
index.html

index 47fc52302155e8dce3bcece4b7be320d9e29b097..9b77893fe2e23258a4e1a6446f78a0061497bb97 100644 (file)
@@ -85,5 +85,29 @@ we agreed upon the following goals for i3:
     of code. If it needs to be a bit bigger, it will be.
   </li> 
 </ol> 
+
+<p>
+In addition to these stated goals, we try our best to uphold the following
+values when considering contributions to the project:
+</p>
+
+<ul>
+  <li>
+    Never break configuration files or existing workflows. Breaking changes
+    require a major version bump (v4 → v5).
+  </li>
+  <li>
+    Keep mental complexity low: once you know i3’s key features, other features
+    should be easy to understand.
+  </li>
+  <li>
+    Only add features which benefit many people, instead of going to great
+    lengths to support rarely used workflows.
+  </li>
+  <li>
+    Only documented behavior is supported. Clear documentation is a requirement
+    for contributions.
+  </li>
+</ul>
  
 </div>