@@ -676,11 +676,11 @@ the instance location to be deprecated if any occurrence specifies a `true`
676
676
value.
677
677
678
678
If ` deprecated ` has a value of boolean ` true ` , it indicates that applications
679
- SHOULD refrain from usage of the declared property. It MAY mean the property is
679
+ SHOULD refrain from usage of the declared property. It may mean the property is
680
680
going to be removed in the future.
681
681
682
682
A root schema containing ` deprecated ` with a value of ` true ` indicates that the
683
- entire resource being described MAY be removed in the future.
683
+ entire resource being described may be removed in the future.
684
684
685
685
The ` deprecated ` keyword applies to each instance location to which the schema
686
686
object containing the keyword successfully applies. This can result in scenarios
@@ -702,8 +702,8 @@ managed exclusively by the owning authority, and attempts by an
702
702
application to modify the value are expected to be ignored or
703
703
rejected by that owning authority.
704
704
705
- An instance document that is marked as ` readOnly ` for the entire document MAY be
706
- ignored if sent to the owning authority, or MAY result in an error, at the
705
+ An instance document that is marked as ` readOnly ` for the entire document may be
706
+ ignored if sent to the owning authority, or may result in an error, at the
707
707
authority's discretion.
708
708
709
709
If ` writeOnly ` has a value of boolean ` true ` , it indicates that the value is
@@ -712,8 +712,8 @@ be present when sent to the owning authority to update or create the document
712
712
(or the resource it represents), but it will not be included in any updated or
713
713
newly created version of the instance.
714
714
715
- An instance document that is marked as ` writeOnly ` for the entire document MAY
716
- be returned as a blank document of some sort, or MAY produce an error upon
715
+ An instance document that is marked as ` writeOnly ` for the entire document may
716
+ be returned as a blank document of some sort, or may produce an error upon
717
717
retrieval, or have the retrieval request ignored, at the authority's discretion.
718
718
719
719
For example, ` readOnly ` would be used to mark a database-generated serial number
0 commit comments