From ce46165d5356c2d47353ce6795d6a824a2d0ee81 Mon Sep 17 00:00:00 2001
From: Priya Wadhwa <priya@chainguard.dev>
Date: Mon, 7 Feb 2022 15:16:03 -0800
Subject: [PATCH] Add FEATURES.md and DEPRECATIONS.md

Signed-off-by: Priya Wadhwa <priya@chainguard.dev>
---
 DEPRECATIONS.md | 10 ++++++++++
 FEATURES.md     | 16 ++++++++++++++++
 2 files changed, 26 insertions(+)
 create mode 100644 DEPRECATIONS.md
 create mode 100644 FEATURES.md

diff --git a/DEPRECATIONS.md b/DEPRECATIONS.md
new file mode 100644
index 000000000000..ee6d1cf9af30
--- /dev/null
+++ b/DEPRECATIONS.md
@@ -0,0 +1,10 @@
+# Deprecations
+
+This doc lists deprecated features in `cosign`.
+You can read more about Sigstore's deprecation policy [here](https://docs.sigstore.dev/api-stability)!
+
+| **Feature Being Deprecated** | **API Stability Level** | **Earliest Date of Removal** |
+|------------------------------|-------------------------|------------------------------|
+| My feature                   | Experimental/Beta/GA    | DD/MM/YY                     |
+|                              |                         |                              |
+|                              |                         |                              |
diff --git a/FEATURES.md b/FEATURES.md
new file mode 100644
index 000000000000..7666eb83dfe8
--- /dev/null
+++ b/FEATURES.md
@@ -0,0 +1,16 @@
+# Feature Stability
+
+This doc covers feature stability in `cosign` as described in the [API Stability Policy](https://docs.sigstore.dev/api-stability) for Sigstore.
+
+Experimental:
+* Keyless signing
+* Storing signatures in a transparency log
+* The `pkg/cosign/oci` client library
+
+
+Beta:
+* All cosign subcommands, including flags and output
+
+
+General Availability:
+* None, yet!