From 1dfa5b95a5a30ed65a063f2192bc6e7d31f5b5f7 Mon Sep 17 00:00:00 2001
From: Jordan Liggitt <liggitt@google.com>
Date: Tue, 12 Jan 2021 10:27:14 -0500
Subject: [PATCH] Add API testdata population instructions

---
 staging/src/k8s.io/api/testdata/README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/staging/src/k8s.io/api/testdata/README.md b/staging/src/k8s.io/api/testdata/README.md
index eec9a8cd420..425b30be226 100644
--- a/staging/src/k8s.io/api/testdata/README.md
+++ b/staging/src/k8s.io/api/testdata/README.md
@@ -2,6 +2,21 @@
 
 This directory tree contains serialized API objects in json, yaml, and protobuf formats.
 
+## Populating data for each release
+
+After every v1.x.0 release, snapshot compatibility data.
+
+For example, to capture compatibility data for `v1.20.0`:
+
+```sh
+export VERSION=v1.20.0
+git checkout ${VERSION}
+cp -fr staging/src/k8s.io/api/testdata/{HEAD,${VERSION}}
+git checkout -b ${VERSION}-api-testdata master
+git add .
+git commit -m "Add ${VERSION} API testdata"
+```
+
 ## Current version
 
 The `HEAD` subdirectory contains serialized API objects generated from the current commit: