@@ -676,11 +676,11 @@ the instance location to be deprecated if any occurrence specifies a `true`
676676value.
677677
678678If ` 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
680680going to be removed in the future.
681681
682682A 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.
684684
685685The ` deprecated ` keyword applies to each instance location to which the schema
686686object containing the keyword successfully applies. This can result in scenarios
@@ -702,8 +702,8 @@ managed exclusively by the owning authority, and attempts by an
702702application to modify the value are expected to be ignored or
703703rejected by that owning authority.
704704
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
707707authority's discretion.
708708
709709If ` 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
712712(or the resource it represents), but it will not be included in any updated or
713713newly created version of the instance.
714714
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
717717retrieval, or have the retrieval request ignored, at the authority's discretion.
718718
719719For example, ` readOnly ` would be used to mark a database-generated serial number
0 commit comments