diff --git a/index.html b/index.html
index 269e9b9..8f82dcf 100644
--- a/index.html
+++ b/index.html
@@ -265,13 +265,48 @@
Query and Response Types
The query type serves as the main extension point mechanism for
-requests for data in the presentation. This document defines several common query
-types.
+requests for data in the presentation. While this document defines several
+common query types, all query objects are of the following form:
+
+ - query
+ -
+A REQUIRED property that specifies the information requested by the
+[=verifier=]. The value MUST be one or more [=maps=] where each [=map=] MUST
+define a `type` property with an associated [=string=] value.
+
+ - challenge
+ -
+An OPTIONAL, unique [=string=] that is provided by a [=verifier=] to a
+[=holder=] during a specific [=presentation request=]. The [=holder=] includes
+the data in a [=verifiable presentation=] to the [=verifier=] to protect against
+replay attacks.
+
+ - domain
+ -
+An OPTIONAL [=string=] that is provided by a [=verifier=] to a [=holder=] during
+a [=presentation request=]. The [=holder=] checks to ensure that the data is
+associated with the domain, such as a website domain, that they are interacting
+with, and if it is, includes the data in a [=verifiable presentation=]. A domain
+is used to ensure that the [=holder=] limits their [=verifiable presentation=]
+to a specific [=verifier=] in order to protect against
+replay attacks.
+
+
+
+
Query By Example
+
+The "query by example" credential query format is designed to enable developers
+to easily request the [=claims=] in one or more [=verifiable credentials=] that
+they need to perform a particular business process. The query can also
+specify one or more [=issuers=] that is trusted by the [=verifier=] as well as
+properties that prevent replay attacks such as a [=challenge=] and [=domain=].
+
+
{
"query": [
@@ -304,10 +339,6 @@ Query By Example
"required": true,
"issuer": "urn:some:required:issuer"
}
- ],
- // (Optional)
- "issuerQuery": [
- //
]
}
]