diff --git a/hack/PRINCIPLES.md b/hack/PRINCIPLES.md index 77ce4f5e51..e59c167598 100644 --- a/hack/PRINCIPLES.md +++ b/hack/PRINCIPLES.md @@ -5,6 +5,10 @@ In the design and development of Docker we try to follow these principles: (Work in progress) * Don't try to replace every tool. Instead, be an ingredient to improve them. +* Less code is better. +* Less components is better. Do you really need to add one more class? +* 50 lines of straightforward, readable code is better than 10 lines of magic that nobody can understand. +* Don't do later what you can do now. "//FIXME: refactor" is not acceptable in new code. * When hesitating between 2 options, choose the one that is easier to reverse. * No is temporary, Yes is forever. If you're not sure about a new feature, say no. You can change your mind later. * Containers must be portable to the greatest possible number of machines. Be suspicious of any change which makes machines less interchangeable.