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