From 97d5f525f42cae0468239de0a924d6fda920b48a Mon Sep 17 00:00:00 2001 From: Solomon Hykes Date: Wed, 5 Jun 2013 17:27:53 +0200 Subject: [PATCH] hack/PRINCIPLES.md: a list of principles guiding Docker's design. The goal is to scale the decision-making in the project and remove @shykes as a bottleneck as much as possible --- hack/PRINCIPLES.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 hack/PRINCIPLES.md diff --git a/hack/PRINCIPLES.md b/hack/PRINCIPLES.md new file mode 100644 index 0000000000..77ce4f5e51 --- /dev/null +++ b/hack/PRINCIPLES.md @@ -0,0 +1,15 @@ +# Docker principles + +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. +* 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. +* The less moving parts in a container, the better. +* Don't merge it unless you document it. +* Don't document it unless you can keep it up-to-date. +* Don't merge it unless you test it! +* Everyone's problem is slightly different. Focus on the part that is the same for everyone, and solve that.