@@ -1653,7 +1653,7 @@ Link: <https://schema.example.com/entry> rel=describedBy
1653
1653
described by "submissionSchema" and "submission MediaType".
1654
1654
</t >
1655
1655
<t >
1656
- Therefore, we use "submissionMediaType" to indicate a multipart/alternative
1656
+ We use "submissionMediaType" to indicate a multipart/alternative
1657
1657
payload format, providing two representations of the same data (HTML and
1658
1658
plain text). Since a multipart/alternative message is an ordered sequence
1659
1659
(the last part is the most preferred alternative), we model the sequence as
@@ -1666,32 +1666,6 @@ Link: <https://schema.example.com/entry> rel=describedBy
1666
1666
each part and are not ordered, should be modeled as JSON objects rather than
1667
1667
arrays.
1668
1668
</t >
1669
- <t >
1670
- For the URI parameters, each of the three demonstrates a different way of
1671
- resolving the input:
1672
- <list style =" hanging" >
1673
- <t hangText =" email:" >
1674
- This variable's presence in "templateRequired" means that it must be
1675
- resolved for the template to be used. Since the "false" schema
1676
- assigned to it in "hrefSchema" excludes it from the input data set,
1677
- it must be resolved from the instance.
1678
- </t >
1679
- <t hangText =" title:" >
1680
- The instance field matching this variable is required, and it is also
1681
- allowed in the input data. So its instance value is used to
1682
- pre-populate the input data set before accepting the client's input.
1683
- The client can opt to leave the instance value in place. Since
1684
- this field is required in "hrefSchema", the client cannot delete it
1685
- (although it could set it to an empty string).
1686
- </t >
1687
- <t hangText =" cc:" >
1688
- The "false" schema set for this in the main schema prevents this field
1689
- from having an instance value. If it is present at all, it must come
1690
- from client input. As it is not required in "hrefSchema", it may not
1691
- be used at all.
1692
- </t >
1693
- </list >
1694
- </t >
1695
1669
<figure >
1696
1670
<preamble >
1697
1671
Note that some lines are wrapped to fit this document's width restrictions.
@@ -1754,6 +1728,32 @@ Link: <https://schema.example.com/entry> rel=describedBy
1754
1728
}]]>
1755
1729
</artwork >
1756
1730
</figure >
1731
+ <t >
1732
+ For the URI parameters, each of the three demonstrates a different way of
1733
+ resolving the input:
1734
+ <list style =" hanging" >
1735
+ <t hangText =" email:" >
1736
+ This variable's presence in "templateRequired" means that it must be
1737
+ resolved for the template to be used. Since the "false" schema
1738
+ assigned to it in "hrefSchema" excludes it from the input data set,
1739
+ it must be resolved from the instance.
1740
+ </t >
1741
+ <t hangText =" title:" >
1742
+ The instance field matching this variable is required, and it is also
1743
+ allowed in the input data. So its instance value is used to
1744
+ pre-populate the input data set before accepting the client's input.
1745
+ The client can opt to leave the instance value in place. Since
1746
+ this field is required in "hrefSchema", the client cannot delete it
1747
+ (although it could set it to an empty string).
1748
+ </t >
1749
+ <t hangText =" cc:" >
1750
+ The "false" schema set for this in the main schema prevents this field
1751
+ from having an instance value. If it is present at all, it must come
1752
+ from client input. As it is not required in "hrefSchema", it may not
1753
+ be used at all.
1754
+ </t >
1755
+ </list >
1756
+ </t >
1757
1757
<t >
1758
1758
So, given the following instance retrieved from "https://api.example.com/stuff":
1759
1759
</t >
0 commit comments