updated README.md and added spec.md

Author: somersbmatthews

Diff for: README.md

@@ -1,12 +1,32 @@
-# DRAFT ONLY : UNTIL KEP IS MERGED 
-  https://github.com/kubernetes/enhancements/pull/1383
+COSI repos:
+
+[Spec](https://github.com/kubernetes-sigs/container-object-storage-interface-spec) \
+[API](https://github.com/kubernetes-sigs/container-object-storage-interface-api) \
+[Controller](https://github.com/kubernetes-sigs/container-object-storage-interface-controller) \
+[Provisioner Sidecar](https://github.com/kubernetes-sigs/container-object-storage-interface-provisioner-sidecar) \
+[CSI Adapter](https://github.com/kubernetes-sigs/container-object-storage-interface-csi-adapter) 
+
+COSI deprecated repos:
+
+[Spec](https://github.com/container-object-storage-interface/spec) \
+[API](https://github.com/container-object-storage-interface/api) \
+[Manager (i.e. Controller)](https://github.com/container-object-storage-interface/cosi-controller-manager) \
+[Provisioner Sidecar](https://github.com/container-object-storage-interface/cosi-provisioner-sidecar) \
+[Ephemeral CSI Driver](https://github.com/container-object-storage-interface/ephemeral-csi-driver) 
+
+
 
 # Container Object Storage Specification
 
 Kubernetes specific Container Object Storage Interface (COSI) components.
 
 ## Community, discussion, contribution, and support
 
+If you are new to a SIG Storage project, check out this [contributing guide](https://github.com/kubernetes/community/blob/master/sig-storage/CONTRIBUTING.md) 
+and the [community page](https://github.com/kubernetes/community/tree/master/sig-storage). 
+
+If you are new to the SIG Storage  COSI project, check out the [spec](https://github.com/kubernetes-sigs/container-object-storage-interface-spec/blob/master/spec.md), [KEP](https://github.com/kubernetes/enhancements/tree/master/keps/sig-storage/1979-object-storage-support), and [project board](https://github.com/orgs/kubernetes-sigs/projects/8#card-40949963).
+
 Learn how to engage with the Kubernetes community on the [community page](http://kubernetes.io/community/).
 
 You can reach the maintainers of this project at:

Diff for: spec.md

@@ -0,0 +1,18 @@
+#Container Object Storage Interface (COSI)
+
+<!-- Based on https://github.com/container-storage-interface/spec -->
+
+Authors:
+
+TODO put authors' names and emails here.
+
+##Notational Conventions
+
+The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" are to be interpreted as described in [RFC 2119](http://tools.ietf.org/html/rfc2119) (Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997).
+
+The key words "unspecified", "undefined", and "implementation-defined" are to be interpreted as described in the [rationale for the C99 standard](http://www.open-std.org/jtc1/sc22/wg14/www/C99RationaleV5.10.pdf#page=18).
+
+An implementation is not compliant if it fails to satisfy one or more of the MUST, REQUIRED, or SHALL requirements for the protocols it implements.
+An implementation is compliant if it satisfies all the MUST, REQUIRED, and SHALL requirements for the protocols it implements.
+
+