@@ -661,11 +661,11 @@ the instance location to be deprecated if any occurrence specifies a `true`
661661value.
662662
663663If ` 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
665665going to be removed in the future.
666666
667667A 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.
669669
670670The ` deprecated ` keyword applies to each instance location to which the schema
671671object containing the keyword successfully applies. This can result in scenarios
@@ -687,8 +687,8 @@ managed exclusively by the owning authority, and attempts by an
687687application to modify the value are expected to be ignored or
688688rejected by that owning authority.
689689
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
692692authority's discretion.
693693
694694If ` 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
697697(or the resource it represents), but it will not be included in any updated or
698698newly created version of the instance.
699699
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
702702retrieval, or have the retrieval request ignored, at the authority's discretion.
703703
704704For example, ` readOnly ` would be used to mark a database-generated serial number
0 commit comments