KMS vault provider

OWNERS_ALIASES

@@ -100,5 +100,77 @@ aliases:
   sig-apps-api-approvers:
     - erictune
     - smarterclayton
-  sig-leads:
+  milestone-maintainers:
+    - lavalamp
+    - deads2k
+    - michelleN
+    - mattfarina
+    - prydonius
+    - bgrant0607
+    - jdumars
+    - ericchiang
+    - liggitt
+    - deads2k
+    - mwielgus
+    - directxman12
+    - justinsb
+    - kris-nova
+    - chrislovecnm
+    - mfburnett
+    - slack
+    - colemickens
+    - foxish
+    - fabianofranz
+    - pwittrock
+    - AdoHe
+    - lukemarsden
+    - jbeda
+    - roberthbailey
+    - zehicle
+    - jdumars
+    - grodrigues3
+    - Phillels
+    - devin-donnelly
+    - jaredbhatti
+    - csbell
+    - quinton-hoole
+    - piosz
+    - fabxc
+    - thockin
+    - dcbw
+    - caseydavenport
+    - dchen1107
+    - derekwaynecarr
+    - zen
+    - marcoceppi
+    - dghubble
+    - idvoretskyi
+    - xsgordon
+    - apsinha
+    - idvoretskyi
+    - calebamiles
+    - pwittrock
+    - calebamiles
+    - wojtek-t
+    - countspongebob
+    - jbeda
+    - davidopp
+    - timothysc
+    - pmorie
+    - arschles
+    - vaikas-google
+    - duglin
+    - saad-ali
+    - childsb
     - spiffxp
+    - fejta
+    - timothysc
+    - danielromlein
+    - floreks
+    - michmike
+    - abgworrall
+    - krzyzacy
+    - steveperry-53
+    - radhikpac
+    - jpbetz
+

api/OWNERS

@@ -3,6 +3,8 @@ approvers:
 - lavalamp
 - smarterclayton
 - thockin
+- liggitt
+# - bgrant0607 # manual	escalations only
 reviewers:
 - thockin
 - lavalamp

api/openapi-spec/README.md

@@ -0,0 +1,60 @@
+# Kubernetes's OpenAPI Specification
+
+This folder contains an [OpenAPI specification][openapi] for Kubernetes API.
+
+## Vendor Extensions
+
+Kuberntes extends OpenAPI using these extensions. Note the version that 
+extensions has been added.
+
+### `x-kubernetes-group-version-kind`
+
+Operations and Definitions may have `x-kubernetes-group-version-kind` if they
+are associated with a [kubernetes resource](https://github.com/kubernetes/community/blob/master/contributors/devel/api-conventions.md#resources).
+
+
+For example:
+
+``` json
+"paths": {
+    ...
+    "/api/v1/namespaces/{namespace}/pods/{name}": {
+        ...
+        "get": {
+        ...
+            "x-kubernetes-group-version-kind": {
+            "group": "",
+            "version": "v1",
+            "kind": "Pod"
+            }
+        }
+    }
+}
+```
+
+### `x-kubernetes-action`
+
+Operations and Definitions may have `x-kubernetes-action` if they
+are associated with a [kubernetes resource](https://github.com/kubernetes/community/blob/master/contributors/devel/api-conventions.md#resources).
+Action can be one of `get`, `list`, `put`, `patch`, `post`, `delete`, `deletecollection`, `watch`, `watchlist`, `proxy`, or `connect`.
+
+
+For example:
+
+``` json
+"paths": {
+    ...
+    "/api/v1/namespaces/{namespace}/pods/{name}": {
+        ...
+        "get": {
+        ...
+            "x-kubernetes-action": "list"
+        }
+    }
+}
+```
+
+### `x-kubernetes-patch-strategy` and `x-kubernetes-patch-merge-key`
+
+Some of the definitions may have these extensions. For more information about PatchStrategy and PatchMergeKey see 
+[strategic-merge-patch] (https://github.com/kubernetes/community/blob/3a1e6d22f812751ee88eccf7c59101852de63d5b/contributors/devel/strategic-merge-patch.md).