diff --git a/spec/src/main/asciidoc/jsonb.asciidoc b/spec/src/main/asciidoc/jsonb.asciidoc
index f26f68ae..4c6dd7cd 100644
--- a/spec/src/main/asciidoc/jsonb.asciidoc
+++ b/spec/src/main/asciidoc/jsonb.asciidoc
@@ -146,4 +146,12 @@ A query that requests a Widget's construction date would get a result like this:
 The date format string specified in the `@JsonbDateFormat` annotation will be used as the field's description in the
 schema, if no `@Description` annotation is provided for that field. If the same field (or property) contains both 
 `@JsonbDateFormat` and `@Description` annotations, it should be considered a best practice to document the date format
-in the description text so that the format is communicated to clients in the schema.
\ No newline at end of file
+in the description text so that the format is communicated to clients in the schema.
+
+=== JSON-B Annotations vs MP GraphQL Annotations
+
+The `@JsonbProperty` annotation can be used interchangeably with `@Name`. If both annotations are used on the same
+member, the `@Name` annotation will take precendence when determining the field name in the schema and the JSON property
+in the response.
+
+Likewise, `@JsonbTransient` can be used interchangeably with `@Ignore`. 
\ No newline at end of file