@@ -661,11 +661,11 @@ the instance location to be deprecated if any occurrence specifies a `true`
661
661
value.
662
662
663
663
If ` deprecated ` has a value of boolean ` true ` , it indicates that applications
664
- SHOULD refrain from usage of the declared property. It MAY mean the property is
664
+ SHOULD refrain from usage of the declared property. It may mean the property is
665
665
going to be removed in the future.
666
666
667
667
A root schema containing ` deprecated ` with a value of ` true ` indicates that the
668
- entire resource being described MAY be removed in the future.
668
+ entire resource being described may be removed in the future.
669
669
670
670
The ` deprecated ` keyword applies to each instance location to which the schema
671
671
object containing the keyword successfully applies. This can result in scenarios
@@ -687,8 +687,8 @@ managed exclusively by the owning authority, and attempts by an
687
687
application to modify the value are expected to be ignored or
688
688
rejected by that owning authority.
689
689
690
- An instance document that is marked as ` readOnly ` for the entire document MAY be
691
- ignored if sent to the owning authority, or MAY result in an error, at the
690
+ An instance document that is marked as ` readOnly ` for the entire document may be
691
+ ignored if sent to the owning authority, or may result in an error, at the
692
692
authority's discretion.
693
693
694
694
If ` writeOnly ` has a value of boolean ` true ` , it indicates that the value is
@@ -697,8 +697,8 @@ be present when sent to the owning authority to update or create the document
697
697
(or the resource it represents), but it will not be included in any updated or
698
698
newly created version of the instance.
699
699
700
- An instance document that is marked as ` writeOnly ` for the entire document MAY
701
- be returned as a blank document of some sort, or MAY produce an error upon
700
+ An instance document that is marked as ` writeOnly ` for the entire document may
701
+ be returned as a blank document of some sort, or may produce an error upon
702
702
retrieval, or have the retrieval request ignored, at the authority's discretion.
703
703
704
704
For example, ` readOnly ` would be used to mark a database-generated serial number
0 commit comments