diff --git a/ui/lib/kv/addon/components/kv-subkeys.js b/ui/lib/kv/addon/components/kv-subkeys.js
index 9c59942e25f8..95b633f1c761 100644
--- a/ui/lib/kv/addon/components/kv-subkeys.js
+++ b/ui/lib/kv/addon/components/kv-subkeys.js
@@ -9,18 +9,29 @@ import { tracked } from '@glimmer/tracking';
/**
* @module KvSubkeys
* @description
- * ```
- * sample subkeys:
- {
+sample secret data:
+```
+ {
+ "foo": "abc",
+ "bar": {
+ "baz": "def"
+ },
+ "quux": {}
+}
+```
+sample subkeys:
+```
+ this.subkeys = {
"bar": {
"baz": null
},
"foo": null,
"quux": null
}
- * ```
+```
*
- *
+ * @example
+ *
*
* @param {object} subkeys - leaf keys of a kv v2 secret, all values (unless a nested object with more keys) return null
*/