From cab3fd0d5fbfba9e736b3cb0530eeb14a106d228 Mon Sep 17 00:00:00 2001 From: Steven Dake Date: Tue, 22 Nov 2016 00:55:54 -0700 Subject: [PATCH] Add specs are advisory readme.rst to kolla repo Change-Id: I1dfbd2f9dbe2e320bc8b8f5e905d0bc600ba3d24 --- specs/README.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 specs/README.rst diff --git a/specs/README.rst b/specs/README.rst new file mode 100644 index 0000000000..a2a9791e4a --- /dev/null +++ b/specs/README.rst @@ -0,0 +1,17 @@ +========================== +Specfications are Advisory +========================== + +This project is under heavy active development. Specifications in this repository +reflects general consensus of ideas at the time the specification was conceived rather +then set of actions to take or a commitment to precisely implement the specification. +As an example, kolla-ansible looks much different today than then ansible-multi spec. +For Kolla old-timers, many know that Kolla in its present form may not have existed +without this general consensus of ideas set by ansible-multi. + +All specifications in this repository are subject to abandonment in the future if +the development team finds it necessary to change course. + +The single source of truth for development work is recorded in blueprints as specifications +are immutable once committed to the repository. Blueprints on the other hand are dynamic +and may be changed at any time along with the codebase.