aboutsummaryrefslogtreecommitdiff
path: root/specs/README.rst
diff options
context:
space:
mode:
authorSteven Dake <stdake@cisco.com>2016-11-22 00:55:54 -0700
committerSteven Dake <stdake@cisco.com>2016-11-22 22:28:02 -0700
commitcab3fd0d5fbfba9e736b3cb0530eeb14a106d228 (patch)
treec0d40d5ec60fbb0630682b5e1c2b46694752af22 /specs/README.rst
parent7bb88390d88aebfc257e09e7e055a09fe4121782 (diff)
downloadkolla-cab3fd0d5fbfba9e736b3cb0530eeb14a106d228.tar.gz
kolla-cab3fd0d5fbfba9e736b3cb0530eeb14a106d228.zip
Add specs are advisory readme.rst to kolla repo
Change-Id: I1dfbd2f9dbe2e320bc8b8f5e905d0bc600ba3d24
Diffstat (limited to 'specs/README.rst')
-rw-r--r--specs/README.rst17
1 files changed, 17 insertions, 0 deletions
diff --git a/specs/README.rst b/specs/README.rst
new file mode 100644
index 000000000..a2a9791e4
--- /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.