From 0710ba5eab0d330223cc8bfeef6d3411ef63a231 Mon Sep 17 00:00:00 2001
From: Michael Richardson <mcr+ietf@sandelman.ca>
Date: Fri, 4 Oct 2024 12:28:10 -0400
Subject: [PATCH] added descriptions for new choice structure

---
 ietf-voucher-request.yang | 1 +
 ietf-voucher.yang         | 4 ++++
 2 files changed, 5 insertions(+)

diff --git a/ietf-voucher-request.yang b/ietf-voucher-request.yang
index e226d24..5370f89 100644
--- a/ietf-voucher-request.yang
+++ b/ietf-voucher-request.yang
@@ -150,6 +150,7 @@ RFCEDITOR: please replace XXXX with the RFC number assigned.
         }
 
         choice registrar-identity {
+          description "One of these three attributes will be used to pin the registrar identity";
           leaf proximity-registrar-cert {
             type binary;
             description
diff --git a/ietf-voucher.yang b/ietf-voucher.yang
index ba9d48e..710d24d 100644
--- a/ietf-voucher.yang
+++ b/ietf-voucher.yang
@@ -165,6 +165,9 @@ RFCEDITOR: please replace XXXX with the RFC number assigned.
            otherwise unique within the scope of the MASA.";
       }
       choice pinning {
+        description "One of these attributes is used by the pledge to
+                     specify the registrar, and how the pledge would like
+                     the registrar's identity to be pinned";
         leaf pinned-domain-cert {
           type binary;
           description
@@ -233,6 +236,7 @@ RFCEDITOR: please replace XXXX with the RFC number assigned.
            certificate.";
       }
       choice nonceless {
+        description "Either a nonce must be present, or an expires-on header";
         leaf expires-on {
           type yang:date-and-time;
           description