Diff of /xml/iffy/index.html

Revision f19e4870e2c719f71d2f5024cb3e2e8f477622dc => 0df7787c056ab2b983e2de4d107c2fa477b7c8f4


Linef19e4870e2c719f71d2f5024cb3e2e8f477622dc0df7787c056ab2b983e2de4d107c2fa477b7c8f4
1<!DOCTYPE html><!DOCTYPE html>
2<html><html>
3 <head> <head>
83 <hr class="below-title"> <hr class="below-title">
84 </div> </div>
85 <div class="update-prepend rss-description-exclude"> <div class="update-prepend rss-description-exclude">
86 <em> ➣  This post was meaningfully revised at 2024-06-17 @ 11:50 PM EDT. The previous revision is <a href="index-oldcommit-b8f2ae57694f9fb88b10df011f69ee9acfe4c0ac.html">here</a>, diff <a href="index-diff-b8f2ae57694f9fb88b10df011f69ee9acfe4c0ac-to-current.html">here</a>. (See <a href="index.html#update-history">update history</a>.) <br> <em> ➣  This post was meaningfully revised at 2024-06-20 @ 11:05 AM EDT. The previous revision is <a href="index-oldcommit-f19e4870e2c719f71d2f5024cb3e2e8f477622dc.html">here</a>, diff <a href="index-diff-f19e4870e2c719f71d2f5024cb3e2e8f477622dc-to-current.html">here</a>. (See <a href="index.html#update-history">update history</a>.) <br>
87 ➣  This post is expected to evolve over time. You can subscribe to ongoing updates <a href="index-sprout.rss">here</a>. ➣  This post is expected to evolve over time. You can subscribe to ongoing updates <a href="index-sprout.rss">here</a>.
88 <link rel="alternate" type="application/rss+xml" title="Update to The 'iffy' XML namespace" href="https://tech.interfluidity.com/xml/iffy/index-sprout.rss"></em> <link rel="alternate" type="application/rss+xml" title="Update to The 'iffy' XML namespace" href="https://tech.interfluidity.com/xml/iffy/index-sprout.rss"></em>
89 <hr> <hr>
107 <li><a href="#iffy-restriction"><code>iffy:restriction</code></a></li> <li><a href="#iffy-restriction"><code>iffy:restriction</code></a></li>
108 <li><a href="#iffy-revision"><code>iffy:revision</code></a></li> <li><a href="#iffy-revision"><code>iffy:revision</code></a></li>
109 <li><a href="#iffy-synthetic"><code>iffy:synthetic</code></a></li> <li><a href="#iffy-synthetic"><code>iffy:synthetic</code></a></li>
110 <li><a href="#iffy-type"><code>iffy:type</code></a></li>
111 <li><a href="#iffy-update"><code>iffy:update</code></a></li> <li><a href="#iffy-update"><code>iffy:update</code></a></li>
112 <li><a href="#iffy-update-history"><code>iffy:update-history</code></a></li> <li><a href="#iffy-update-history"><code>iffy:update-history</code></a></li>
113 </ul> </ul>
131 <li> <li>
132 <p><code>Content</code> commits that each item, either inside its <code>description</code> tag, or via an extension such as <code>content:encoded</code>, includes the full content of the items it includes, suitable for independent rendering by any client capable also of resolving references to linked media externally. No limitation is placed on whether the full content is placed in a <code>description</code> element, in <code>content:encoded</code>, or in some other extension.</p></li> <p><code>Content</code> commits that each item, either inside its <code>description</code> tag, or via an extension such as <code>content:encoded</code>, includes the full content of the items it includes, suitable for independent rendering by any client capable also of resolving references to linked media externally. No limitation is placed on whether the full content is placed in a <code>description</code> element, in <code>content:encoded</code>, or in some other extension.</p></li>
133 <li> <li>
134 <p><code>Media</code> augments <code>Content</code> by <em>embedding attachments to subsidiary media</em> inside the RSS document. Subsidiary media does not include all potential links, just links which share a prefix with the current RSS document, which by default means all links subsidiary to the parent of the RSS document as specified in an <code>atom:link</code></p> <p><code>Media</code> augments <code>Content</code> by <em>embedding attachments to subsidiary media</em> inside the RSS document. Subsidiary media does not include all potential links, just links which share a prefix with the current RSS document, which by default means all links subsidiary to the parent of the RSS document as specified in an <a href="https://datatracker.ietf.org/doc/html/rfc4287#section-4.2.7"><code>atom:link</code></a></p>
135 <p><em>More information on this soon when <code>iffy:attachment</code> is defined</em></p></li> <p><em>More information on this soon when <code>iffy:attachment</code> is defined</em></p></li>
136 </ul> </ul>
137 <p>The four values represent nested, hierarchical levels of commitment. <code>Ping</code> commits to nothing more than the spec requires. <code>Media</code> makes every commitment promised by the prior three levels, and an additional one.</p> <p>The four values represent nested, hierarchical levels of commitment. <code>Ping</code> commits to nothing more than the spec requires. <code>Media</code> makes every commitment promised by the prior three levels, and an additional one.</p>
206 <p><a id="iffy-provenance" href=""></a><strong>Element — <code>iffy:provenance</code></strong></p> <p><a id="iffy-provenance" href=""></a><strong>Element — <code>iffy:provenance</code></strong></p>
207 <div class="iffy-element-desc"> <div class="iffy-element-desc">
208 <p><strong>When an item level element</strong></p> <p><strong>When an item level element</strong></p>
209 <p>If present in an item, the item contains a sequence of one or more <a href="https://www.ietf.org/rfc/rfc4287.txt"><code>atom:link</code></a> elements, each of whose</p> <p>If present in an item, the item contains a sequence of one or more <a href="https://datatracker.ietf.org/doc/html/rfc4287#section-4.2.7"><code>atom:link</code></a> elements, each of whose</p>
210 <ul> <ul>
211 <li><code>rel</code> attribute is MUST BE <code>via</code></li> <li><code>rel</code> attribute is MUST BE <code>via</code></li>
212 <li><code>href</code> attribute MUST BE the URL of an RSS feed from which the base contents of this item were drawn</li> <li><code>href</code> attribute MUST BE the URL of an RSS feed from which the base contents of this item were drawn</li>
213 <li><code>type</code> attribute SHOULD BE <code>application/rss+xml</code></li> <li><code>type</code> attribute SHOULD BE <code>application/rss+xml</code></li>
214 </ul> </ul>
215 <p>If the item from which the current item was sourced does not contain an <code>iffy:provenance</code>, then the current item should include just one <code>atom:link</code>.</p> <p>If the item from which the current item was sourced does not contain an <code>iffy:provenance</code>, then the current item should include just one <a href="https://datatracker.ietf.org/doc/html/rfc4287#section-4.2.7"><code>atom:link</code></a>.</p>
216 <p>If the item from which the current item was sourced <em>does</em> contains an <code>iffy:provenance</code>, then the current feed SHOULD include all items of that element, with the URL of the feed from which the item was sourced PREPENDED.</p> <p>If the item from which the current item was sourced <em>does</em> contains an <code>iffy:provenance</code>, then the current feed SHOULD include all items of that element, with the URL of the feed from which the item was sourced PREPENDED.</p>
217 <p>This will ensure the most immediate source will be the first <code>atom:link</code> element. The origin — or at least the source for which no further provenance is known — will be the last <code>atom:link</code> element.</p> <p>This will ensure the most immediate source will be the first <a href="https://datatracker.ietf.org/doc/html/rfc4287#section-4.2.7"><code>atom:link</code></a> element. The origin — or at least the source for which no further provenance is known — will be the last <a href="https://datatracker.ietf.org/doc/html/rfc4287#section-4.2.7"><code>atom:link</code></a> element.</p>
218 <p>Processors may expect a channel level <code>atom:link</code> element with <code>rel="self"</code> and <code>type="application/rss+xml"</code> to use as the basis for provenance in source documents. See <a href="https://www.rssboard.org/rss-profile#namespace-elements-atom-link">RSS Best Practices</a>.</p> <p>Processors may expect a channel level <a href="https://datatracker.ietf.org/doc/html/rfc4287#section-4.2.7"><code>atom:link</code></a> element with <code>rel="self"</code> and <code>type="application/rss+xml"</code> to use as the basis for provenance in source documents. See <a href="https://www.rssboard.org/rss-profile#namespace-elements-atom-link">RSS Best Practices</a>.</p>
219 <p><strong>Example</strong> (from <a href="https://www.interfluidity.com/unify-rss/all-blogs.rss">here</a>):</p> <p><strong>Example</strong> (from <a href="https://www.interfluidity.com/unify-rss/all-blogs.rss">here</a>):</p>
220 <pre><code class="language-xml"><?xml version='1.0' encoding='UTF-8'?> <pre><code class="language-xml"><?xml version='1.0' encoding='UTF-8'?>
221
257 <hr> <hr>
258 <p><a id="iffy-synthetic" href=""></a><strong>Element — <code>iffy:synthetic</code></strong></p> <p><a id="iffy-synthetic" href=""></a><strong>Element — <code>iffy:synthetic</code></strong></p>
259 <div class="iffy-element-desc"> <div class="iffy-element-desc">
260 <p>This element, usually empty, is intended to mark channels or items that are in some sense "synthetic", rather than, um, hand-made?</p> <p>This element is intended to mark channels or items that are in some sense "synthetic", rather than, um, hand-made?</p>
261 <p>Can optionally contain an <a href="#iffy-type"><code>iffy-type</code></a>, and other type-specific subelements.</p>
262 <p><strong>When a subelement of <code>channel</code></strong></p> <p><strong>When a subelement of <code>channel</code></strong></p>
263 <p>If all the items in this feed are automatically rather than human generated, however you want to defined that, <code>iffy:synthetic</code> can mark an entire channel as synthetic, bot-produced.</p> <p>If <em>all the items</em> in a feed are automatically rather than human generated (however you want to define that), <code>iffy:synthetic</code> can mark an entire channel as synthetic, bot-produced.</p>
264 <p>Applications that include <code>iffy:synthetic</code> as a subject of channel SHOULD NOT also mark individual <code>item</code>s as <code>iffy:synthetic</code>, unless there is some meaningful sense in which some items are <em>more</em> synthetic than others. It serves no purpose to mark every item of a feed <code>iffy:synthetic</code> when the channel is already so marked.</p> <p>Applications that include <code>iffy:synthetic</code> as a direct child of channel SHOULD NOT also mark individual <code>item</code>s as <code>iffy:synthetic</code>, unless there is some meaningful sense in which some items are <em>more</em> synthetic than others. It serves no purpose to mark every item of a feed <code>iffy:synthetic</code> when the channel is already so marked.</p>
265 <p>Known types:</p>
266 <ul>
267 <li>
268 <p><code>ItemUpdateFeed</code> — A synthetic feed announcing updates of a particular logical item from another feed.</p>
269 <p>Elements SHOULD also include an <a href="https://datatracker.ietf.org/doc/html/rfc4287#section-4.2.7"><code>atom:link</code></a> with <code>rel</code> attribute set to <code>related</code>, pointing to the same resource as the <code>link</code> element of the item whose updates are being announced.</p></li>
270 </ul>
271 <p><strong>When a subelement of <code>item</code></strong></p> <p><strong>When a subelement of <code>item</code></strong></p>
272 <p>Marks items as "synthetic", that is <em>more</em> synthetic than other, unmarked items in the feed.</p> <p>Marks items as "synthetic", that is <em>more</em> synthetic than other, unmarked items in the feed.</p>
273 <p>Exactly what that means is not defined, but it should be <em>relative to the other items in the feed</em>. If every item in a feed is automatically generated — suppose a weather feed, announcing conditions on the hour — then those items should NOT be marked <code>iffy:synthetic</code>, because they are the usual for the feed. The <code>channel</code> as a whole might be marked <code>iffy:synthetic</code>.</p> <p>Exactly what that means is not defined, but it should be <em>relative to the other items in the feed</em>. If every item in a feed is automatically generated — suppose a weather feed, announcing conditions on the hour — then those items should NOT be marked <code>iffy:synthetic</code>, because they are the usual for the feed. The <code>channel</code> as a whole might be marked <code>iffy:synthetic</code>.</p>
274 <p>When <code>iffy:synthetic</code> is a subelement of <code>item</code>, it is intended to <em>distinguish</em> more automatic from less automatically produced items. It serves no purpose if it is used to mark all items.</p> <p>When <code>iffy:synthetic</code> is a subelement of <code>item</code>, it is intended to <em>distinguish</em> more automatic from less automatically produced items. It serves no purpose if it is used to mark all items.</p>
275 <p><strong>Example</strong>:</p> <p>Known types:</p>
276 <pre><code class="language-xml"><iffy:synthetic/> <ul>
277 <li><code>UpdateAnnouncement</code> — A synethetic item marking an update of an older item in the feed (or that once would have been in the feed)</li>
278 </ul>
279 <p><strong>Example — <code>channel > iffy:synthetic > iffy:type (ItemUpdateFeed)</code></strong>:</p>
280 <pre><code class="language-xml"> <channel>
281 <!-- other channel elements -->
282 <iffy:synthetic>
283 <iffy:type>ItemUpdateFeed</iffy:type>
284 <atom:link rel="related" href="https://tech.interfluidity.com/xml/iffy/index.html"/>
285 </iffy:synthetic>
286 </channel>
287</code></pre></code></pre>
288 <p><strong>Example — <code>item > iffy:synthetic > iffy:type (UpdateAnnouncement)</code></strong>:</p>
289 <pre><code class="language-xml"> <item>
290 <!-- other item elements -->
291 <iffy:synthetic>
292 <iffy:type>UpdateAnnouncement</iffy:type>
293 </iffy:synthetic>
294 </item>
295</code></pre>
296 </div> </div>
297 <hr> <hr>
298 <p><a id="iffy-type" href=""></a><strong>Element — <code>iffy:type</code></strong></p>
299 <div class="iffy-element-desc">
300 <p>In general, marks the "type" of its containing element.</p>
301 <p><strong>When a subelement of <code>channel</code> > <a href="#iffy-synthetic"><code>iffy:synthetic</code></a></strong></p>
302 <p>Marks what kind of synthetic channel its parent is. Currently known values include</p>
303 <ul>
304 <li><code>ItemUpdateFeed</code> — A synthetic feed announcing updates of a particular logical item from another feed.</li>
305 </ul>
306 <p><strong>When a subelement of <code>item</code> > <a href="#iffy-synthetic"><code>iffy:synthetic</code></a></strong></p>
307 <p>Marks what kind of synthetic item its parent is. Currently known values include</p>
308 <ul>
309 <li><code>UpdateAnnouncement</code> — A synethetic item marking an update of an older item in the feed (or that once would have been in the feed)</li>
310 </ul>
311 <p>Please see known containing elements, including</p>
312 <ul>
313 <li><a href="#iffy-synthetic"><code>iffy:synthetic</code></a>.</li>
314 </ul>
315 </div>
316 <hr>
317 <p><a id="iffy-update" href=""></a><strong>Element — <code>iffy:update</code></strong></p> <p><a id="iffy-update" href=""></a><strong>Element — <code>iffy:update</code></strong></p>
318 <div class="iffy-element-desc"> <div class="iffy-element-desc">
319 <p><strong>When a sub-element of <a href="#iffy-update-history"><code>iffy:update-history</code></a></strong></p> <p><strong>When a sub-element of <a href="#iffy-update-history"><code>iffy:update-history</code></a></strong></p>
392 </div> </div>
393 <div class="entry-footer"> <div class="entry-footer">
394 <div class="post-metainfo"> <div class="post-metainfo">
395 <a href="index.html">04:10 AM EDT</a>
396 <div class="updated-note"> <div class="updated-note">
397 <a href="index.html#major-updates">Last major update at 2024-06-17 @ 11:50 PM EDT</a> <a href="index.html#major-updates">Last major update at 2024-06-20 @ 11:05 AM EDT</a>
398 </div> </div>
399 <div>
400 <a href="index.html" class="pubtime">04:10 AM EDT</a>
401 </div>
402 </div> </div>
403 </div> </div>
404</article></article>
417 <div id="update-history" class="update-history"> <div id="update-history" class="update-history">
418 <h3 class="update-history-title"><a id="major-updates" href=""></a>Major revisions:</h3> <h3 class="update-history-title"><a id="major-updates" href=""></a>Major revisions:</h3>
419 <ul> <ul>
420 <li><span class="update-timestamp"><i>2024-06-17 @ 11:50 PM EDT</i></span> — Document <code>iffy:synthetic</code>. (<a href="index-diff-b8f2ae57694f9fb88b10df011f69ee9acfe4c0ac-to-current.html">diff</a>)</li> <li><span class="update-timestamp"><i>2024-06-20 @ 11:05 AM EDT</i></span> — Document <code>iffy:type</code>, update documentation of <code>iffy:synthetic</code> as optionally including <code>iffy:type</code>. (<a href="index-diff-f19e4870e2c719f71d2f5024cb3e2e8f477622dc-to-current.html">diff</a>)</li>
421 <li><span class="update-timestamp"><i> <a href="index-oldcommit-f19e4870e2c719f71d2f5024cb3e2e8f477622dc.html">2024-06-17 @ 11:50 PM EDT</a></i></span> — Document <code>iffy:synthetic</code>. (<a href="index-diff-b8f2ae57694f9fb88b10df011f69ee9acfe4c0ac-to-f19e4870e2c719f71d2f5024cb3e2e8f477622dc.html">diff</a>)</li>
422 <li><span class="update-timestamp"><i> <a href="index-oldcommit-b8f2ae57694f9fb88b10df011f69ee9acfe4c0ac.html">2024-06-11 @ 02:10 PM EDT</a></i></span> — Document <code>iffy:hint-announce</code>, <code>iffy:policy</code>, and <code>iffy:restriction</code>. (<a href="index-diff-6c5fef82527bd419e8e9c7e7f3a6420c9925cf10-to-b8f2ae57694f9fb88b10df011f69ee9acfe4c0ac.html">diff</a>)</li> <li><span class="update-timestamp"><i> <a href="index-oldcommit-b8f2ae57694f9fb88b10df011f69ee9acfe4c0ac.html">2024-06-11 @ 02:10 PM EDT</a></i></span> — Document <code>iffy:hint-announce</code>, <code>iffy:policy</code>, and <code>iffy:restriction</code>. (<a href="index-diff-6c5fef82527bd419e8e9c7e7f3a6420c9925cf10-to-b8f2ae57694f9fb88b10df011f69ee9acfe4c0ac.html">diff</a>)</li>
423 <li><span class="update-timestamp"><i> <a href="index-oldcommit-6c5fef82527bd419e8e9c7e7f3a6420c9925cf10.html">2024-06-02 @ 12:25 AM EDT</a></i></span> — Drop <code>iffy:timestamp</code>. We can just reuse <code>atom:updated</code> for the same work. (<a href="index-diff-199e44561de3fd9e731a335d8b2a655f42d9bc04-to-6c5fef82527bd419e8e9c7e7f3a6420c9925cf10.html">diff</a>)</li> <li><span class="update-timestamp"><i> <a href="index-oldcommit-6c5fef82527bd419e8e9c7e7f3a6420c9925cf10.html">2024-06-02 @ 12:25 AM EDT</a></i></span> — Drop <code>iffy:timestamp</code>. We can just reuse <code>atom:updated</code> for the same work. (<a href="index-diff-199e44561de3fd9e731a335d8b2a655f42d9bc04-to-6c5fef82527bd419e8e9c7e7f3a6420c9925cf10.html">diff</a>)</li>
424 <li><span class="update-timestamp"><i> <a href="index-oldcommit-199e44561de3fd9e731a335d8b2a655f42d9bc04.html">2024-06-01 @ 09:35 PM EDT</a></i></span> — Add initial take on tags related to updates and revisions. (<a href="index-diff-72eaf9fdfebc9e627bff33bbe1102d4d250ad1d0-to-199e44561de3fd9e731a335d8b2a655f42d9bc04.html">diff</a>)</li> <li><span class="update-timestamp"><i> <a href="index-oldcommit-199e44561de3fd9e731a335d8b2a655f42d9bc04.html">2024-06-01 @ 09:35 PM EDT</a></i></span> — Add initial take on tags related to updates and revisions. (<a href="index-diff-72eaf9fdfebc9e627bff33bbe1102d4d250ad1d0-to-199e44561de3fd9e731a335d8b2a655f42d9bc04.html">diff</a>)</li>
425 <li><span class="update-timestamp"><i> <a href="index-oldcommit-72eaf9fdfebc9e627bff33bbe1102d4d250ad1d0.html">2024-05-25 @ 11:00 PM EDT</a></i></span> — Add JS/CSS so that prior revisions are visually distinct from current. (<a href="index-diff-13de0232319ceab2f830591c318089d18cbec78d-to-72eaf9fdfebc9e627bff33bbe1102d4d250ad1d0.html">diff</a>)</li> <li><span class="update-timestamp"><i> <a href="index-oldcommit-72eaf9fdfebc9e627bff33bbe1102d4d250ad1d0.html">2024-05-25 @ 11:00 PM EDT</a></i></span> — Add JS/CSS so that prior revisions are visually distinct from current. (<a href="index-diff-13de0232319ceab2f830591c318089d18cbec78d-to-72eaf9fdfebc9e627bff33bbe1102d4d250ad1d0.html">diff</a>)</li>
426 <li><span class="update-timestamp"><i> <a href="index-oldcommit-13de0232319ceab2f830591c318089d18cbec78d.html">2024-05-24 @ 12:25 AM EDT</a></i></span> — Drop tags <code>iffy:when-updated</code> and <code>iffy:original-guid</code>, bad appraoch to updates. (<a href="index-diff-394986cb8d9c57f567d324e691a44d50102101ce-to-13de0232319ceab2f830591c318089d18cbec78d.html">diff</a>)</li> <li><span class="update-timestamp"><i> <a href="index-oldcommit-13de0232319ceab2f830591c318089d18cbec78d.html">2024-05-24 @ 12:25 AM EDT</a></i></span> — Drop tags <code>iffy:when-updated</code> and <code>iffy:original-guid</code>, bad appraoch to updates. (<a href="index-diff-394986cb8d9c57f567d324e691a44d50102101ce-to-13de0232319ceab2f830591c318089d18cbec78d.html">diff</a>)</li>
427 <li><span class="update-timestamp"><i> <a href="index-oldcommit-394986cb8d9c57f567d324e691a44d50102101ce.html">2024-05-13 @ 04:10 AM EDT</a></i></span> — Initial publication.</li> <li><span class="update-timestamp"><i> <a href="index-oldcommit-394986cb8d9c57f567d324e691a44d50102101ce.html">2024-05-13 @ 04:10 AM EDT</a></i></span> — Initial publication.</li>
428 </ul> </ul>
429 <div class="update-history-note"> <div class="update-history-note">
430 Timestamps represent "major", substantative revisions. There may have been subsequent typo fixes and language reworkings within a major revision, after the time displayed. For a more complete and fine-grained update history, you can view the <a href="https://github.com/swaldman/tech.interfluidity.com/commits/main/">git repository commit history</a>. The most recent minor modification of this entry occurred 2024-06-17 @ 11:52 PM EDT. Timestamps represent "major", substantative revisions. There may have been subsequent typo fixes and language reworkings within a major revision, after the time displayed. For a more complete and fine-grained update history, you can view the <a href="https://github.com/swaldman/tech.interfluidity.com/commits/main/">git repository commit history</a>. The most recent minor modification of this entry occurred 2024-06-20 @ 11:04 AM EDT.
431 </div> </div>
432 </div> </div>
433</div><!-- after-article --></div><!-- after-article -->
437 </div> </div>
438 </body> </body>
439</html></html>