Diff of /xml/iffy/index.html

Revision 5fcd99373d2d940a0c6e1468979be59e2d6bcced => current

Line5fcd99373d2d940a0c6e1468979be59e2d6bccedcurrent
1<!DOCTYPE html><!DOCTYPE html>
2<html><html>
3 <head> <head>
⋮⋮⋮
84 <hr class="below-title"> <hr class="below-title">
85 </div> </div>
86 <div class="update-prepend rss-description-exclude"> <div class="update-prepend rss-description-exclude">
87 <em> ➣  This post was meaningfully revised at 2024-11-02 @ 05:15 PM EDT. The previous revision is <a href="index-oldcommit-34d8dab8f187c6d9512615dbb83c95395aa49a3b.html">here</a>, diff <a href="index-diff-34d8dab8f187c6d9512615dbb83c95395aa49a3b-to-current.html">here</a>. (See <a href="index.html#update-history">update history</a>.) <br> <em> ➣  This post was meaningfully revised at 2024-11-15 @ 01:10 AM EST. The previous revision is <a href="index-oldcommit-5fcd99373d2d940a0c6e1468979be59e2d6bcced.html">here</a>, diff <a href="index-diff-5fcd99373d2d940a0c6e1468979be59e2d6bcced-to-current.html">here</a>. (See <a href="index.html#update-history">update history</a>.) <br>
88 ➣  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>.
89 <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>
90 <hr> <hr>
⋮⋮⋮
99 <hr> <hr>
100 <h2><a href="#table-of-contents" id="table-of-contents" name="table-of-contents" class="anchorlink"></a>Table of Contents</h2> <h2><a href="#table-of-contents" id="table-of-contents" name="table-of-contents" class="anchorlink"></a>Table of Contents</h2>
101 <ul> <ul>
102 <li><a href="#iffy-all"><code>iffy:all</code></a></li>
103 <li><a href="#iffy-completeness"><code>iffy:completeness</code></a></li> <li><a href="#iffy-completeness"><code>iffy:completeness</code></a></li>
104 <li><a href="#iffy-curation"><code>iffy:curation</code></a></li>
105 <li><a href="#iffy-diff"><code>iffy:diff</code></a></li> <li><a href="#iffy-diff"><code>iffy:diff</code></a></li>
106 <li><a href="#iffy-hint-announce"><code>iffy:hint-announce</code></a></li> <li><a href="#iffy-hint-announce"><code>iffy:hint-announce</code></a></li>
107 <li><a href="#iffy-initial"><code>iffy:initial</code></a></li> <li><a href="#iffy-initial"><code>iffy:initial</code></a></li>
108 <li><a href="#iffy-policy"><code>iffy:policy</code></a></li> <li><a href="#iffy-policy"><code>iffy:policy</code></a></li>
109 <li><a href="#iffy-provenance"><code>iffy:provenance</code></a></li> <li><a href="#iffy-provenance"><code>iffy:provenance</code></a></li>
110 <li><a href="#iffy-recent"><code>iffy:recent</code></a></li>
111 <li><a href="#iffy-restriction"><code>iffy:restriction</code></a></li> <li><a href="#iffy-restriction"><code>iffy:restriction</code></a></li>
112 <li><a href="#iffy-revision"><code>iffy:revision</code></a></li> <li><a href="#iffy-revision"><code>iffy:revision</code></a></li>
113 <li><a href="#iffy-selection"><code>iffy:selection</code></a></li>
114 <li><a href="#iffy-single"><code>iffy:single</code></a></li>
115 <li><a href="#iffy-synthetic"><code>iffy:synthetic</code></a></li> <li><a href="#iffy-synthetic"><code>iffy:synthetic</code></a></li>
116 <li><a href="#iffy-type"><code>iffy:type</code></a></li> <li><a href="#iffy-type"><code>iffy:type</code></a></li>
117 <li><a href="#iffy-uid"><code>iffy:uid</code></a></li> <li><a href="#iffy-uid"><code>iffy:uid</code></a></li>
118 <li><a href="#iffy-update"><code>iffy:update</code></a></li> <li><a href="#iffy-update"><code>iffy:update</code></a></li>
119 <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>
120 </ul> </ul>
121 <hr> <hr>
122 <h2><a href="#element--iffyall-" id="element--iffyall-" name="element--iffyall-" class="anchorlink"></a>Element — <code>iffy:all</code> <a id="iffy-all" href=""></a></h2>
123 <div class="iffy-element-desc">
124 <h3><a href="#when-beneath-iffycuration" id="when-beneath-iffycuration" name="when-beneath-iffycuration" class="anchorlink"></a>When beneath <a href="#iffy-curation"><code>iffy:curation</code></a></h3>
125 <p><code>iffy:all</code> is a <em>curation type</em>, a description of how the feed is curated relative to the body of work a subset of which it presents.</p>
126 <p>Curation type <code>iffy:all</code> signifies that the full, unabridged collection of work is represented by <code>item</code> elements in this feed.</p>
127 <h4><a href="#example" id="example" name="example" class="anchorlink"></a>Example:</h4>
128 <pre><code class="language-xml"><?xml version='1.0' encoding='UTF-8'?>
129
130<rss version="2.0" xmlns:iffy="http://tech.interfluidity.com/xml/iffy/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/">
131 <channel>
132 <title>tech — interfluidity</title>
133 <atom:link type="application/rss+xml" rel="self" href="https://tech.interfluidity.com/feed/index.rss"/>
134 <iffy:curation>
135 <iffy:all/>
136 </iffy:curation>
137 <!-- Other channel elements -->
138 <item>
139 <!-- Other item elements -->
140 </item>
141 </channel>
142</rss>
143</code></pre>
144 </div>
145 <hr>
146 <h2><a href="#element--iffycompleteness-" id="element--iffycompleteness-" name="element--iffycompleteness-" class="anchorlink"></a>Element — <code>iffy:completeness</code> <a id="iffy-completeness" href=""></a></h2> <h2><a href="#element--iffycompleteness-" id="element--iffycompleteness-" name="element--iffycompleteness-" class="anchorlink"></a>Element — <code>iffy:completeness</code> <a id="iffy-completeness" href=""></a></h2>
147 <div class="iffy-element-desc"> <div class="iffy-element-desc">
148 <h3><a href="#solely-a-channel-level-element" id="solely-a-channel-level-element" name="solely-a-channel-level-element" class="anchorlink"></a>Solely a channel level element</h3> <h3><a href="#solely-a-channel-level-element" id="solely-a-channel-level-element" name="solely-a-channel-level-element" class="anchorlink"></a>Solely a channel level element</h3>
⋮⋮⋮
167 </ul> </ul>
168 <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>
169 <p>If not specified, no commitment is made, the feed should be considered <code>Ping</code>.</p> <p>If not specified, no commitment is made, the feed should be considered <code>Ping</code>.</p>
170 <h4><a href="#example" id="example" name="example" class="anchorlink"></a>Example:</h4> <h4><a href="#example-1" id="example-1" name="example-1" class="anchorlink"></a>Example:</h4>
171 <pre><code class="language-xml"><?xml version='1.0' encoding='UTF-8'?> <pre><code class="language-xml"><?xml version='1.0' encoding='UTF-8'?>
172
173<rss version="2.0" xmlns:iffy="http://tech.interfluidity.com/xml/iffy/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/"><rss version="2.0" xmlns:iffy="http://tech.interfluidity.com/xml/iffy/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/">
⋮⋮⋮
185</code></pre></code></pre>
186 </div> </div>
187 <hr> <hr>
188 <h2><a href="#element--iffycuration-" id="element--iffycuration-" name="element--iffycuration-" class="anchorlink"></a>Element — <code>iffy:curation</code> <a id="iffy-curation" href=""></a></h2>
189 <div class="iffy-element-desc">
190 <h3><a href="#solely-a-channel-level-element-1" id="solely-a-channel-level-element-1" name="solely-a-channel-level-element-1" class="anchorlink"></a>Solely a <code>channel</code> level element</h3>
191 <p><code>iffy:curation</code> provides a description of how the feed is curated relative to the body of work a subset of which it presents. It MUST include as a sub-element a <em>curation type</em>. The following curation types are defined:</p>
192 <ul>
193 <li><a href="#iffy-all"><code>iffy:all</code></a></li>
194 <li><a href="#iffy-recent"><code>iffy:recent</code></a></li>
195 <li><a href="#iffy-selection"><code>iffy:selection</code></a></li>
196 <li><a href="#iffy-single"><code>iffy:single</code></a></li>
197 </ul>
198 <h4><a href="#example-2" id="example-2" name="example-2" class="anchorlink"></a>Example:</h4>
199 <pre><code class="language-xml"><?xml version='1.0' encoding='UTF-8'?>
200
201<rss version="2.0" xmlns:iffy="http://tech.interfluidity.com/xml/iffy/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/">
202 <channel>
203 <title>tech — interfluidity</title>
204 <atom:link type="application/rss+xml" rel="self" href="https://tech.interfluidity.com/feed/index.rss"/>
205 <iffy:curation>
206 <iffy:recent last="10"/>
207 </iffy:curation>
208 <!-- Other channel elements -->
209 <item>
210 <!-- Other item elements -->
211 </item>
212 </channel>
213</rss>
214</code></pre>
215 </div>
216 <hr>
217 <h2><a href="#element--iffydiff-" id="element--iffydiff-" name="element--iffydiff-" class="anchorlink"></a>Element — <code>iffy:diff</code> <a id="iffy-diff" href=""></a></h2> <h2><a href="#element--iffydiff-" id="element--iffydiff-" name="element--iffydiff-" class="anchorlink"></a>Element — <code>iffy:diff</code> <a id="iffy-diff" href=""></a></h2>
218 <div class="iffy-element-desc"> <div class="iffy-element-desc">
219 <h3><a href="#when-a-subelement-of-iffyupdate" id="when-a-subelement-of-iffyupdate" name="when-a-subelement-of-iffyupdate" class="anchorlink"></a>When a subelement of <a href="#iffy-update"><code>iffy:update</code></a></h3> <h3><a href="#when-a-subelement-of-iffyupdate" id="when-a-subelement-of-iffyupdate" name="when-a-subelement-of-iffyupdate" class="anchorlink"></a>When a subelement of <a href="#iffy-update"><code>iffy:update</code></a></h3>
220 <p>MUST contain a URL, URI, or <a href="https://datatracker.ietf.org/doc/html/rfc3987">IRI</a> of a human-reviewable a <a href="https://en.wikipedia.org/wiki/Diff"><em>diff</em></a> of the current updated and <em>the final minor revision</em> of the update prior (or of the initially published post, if the current update is the first declared update).</p> <p>MUST contain a URL, URI, or <a href="https://datatracker.ietf.org/doc/html/rfc3987">IRI</a> of a human-reviewable a <a href="https://en.wikipedia.org/wiki/Diff"><em>diff</em></a> of the current updated and <em>the final minor revision</em> of the update prior (or of the initially published post, if the current update is the first declared update).</p>
221 <h4><a href="#example-1" id="example-1" name="example-1" class="anchorlink"></a>Example:</h4> <h4><a href="#example-3" id="example-3" name="example-3" class="anchorlink"></a>Example:</h4>
222 <pre><code class="language-xml"><iffy:diff>https://tech.interfluidity.com/xml/iffy/index-diff-394986cb8d9c57f567d324e691a44d50102101ce-to-13de0232319ceab2f830591c318089d18cbec78d.html</iffy:diff> <pre><code class="language-xml"><iffy:diff>https://tech.interfluidity.com/xml/iffy/index-diff-394986cb8d9c57f567d324e691a44d50102101ce-to-13de0232319ceab2f830591c318089d18cbec78d.html</iffy:diff>
223</code></pre></code></pre>
224 <p>See also <a href="#iffy-update-history"><code>iffy:update-history</code> example</a>.</p> <p>See also <a href="#iffy-update-history"><code>iffy:update-history</code> example</a>.</p>
⋮⋮⋮
237 <p>MAY contain an <a href="#iffy-restriction"><code>iffy:restriction</code></a> element, which represents an application-specific restriction over the consumers to which it is addressed. No restrictions are placed on the content of the <code>iffy:restriction</code> element. Applications can define restrictions as they see fit.</p> <p>MAY contain an <a href="#iffy-restriction"><code>iffy:restriction</code></a> element, which represents an application-specific restriction over the consumers to which it is addressed. No restrictions are placed on the content of the <code>iffy:restriction</code> element. Applications can define restrictions as they see fit.</p>
238 <p>An <code>iffy:hint-announce</code> element with NO <code>iffy:restriction</code> or an empty <code>iffy:restriction</code> tag should be interpreted as the intended default for ALL applications not addressed by an <code>iffy:hint-announce</code> with a more specific restriction.</p> <p>An <code>iffy:hint-announce</code> element with NO <code>iffy:restriction</code> or an empty <code>iffy:restriction</code> tag should be interpreted as the intended default for ALL applications not addressed by an <code>iffy:hint-announce</code> with a more specific restriction.</p>
239 <p>Multiple <code>iffy:hint-announce</code> elements may be placed within a single <code>item</code>, provided that only one has an omitted or empty <code>iffy:restriction</code>, and all <code>iffy:hint-announce</code> elements containing an <code>iffy:restriction</code> contain a unique restriction. Each <code>iffy:restriction</code> SHOULD apply to nonoverlapping application-specific contexts. If that is not the case, how applications prioritize or respond to conflicting <code>iffy-hint-announce</code> elements whose restrictions both apply must be determined by the application.</p> <p>Multiple <code>iffy:hint-announce</code> elements may be placed within a single <code>item</code>, provided that only one has an omitted or empty <code>iffy:restriction</code>, and all <code>iffy:hint-announce</code> elements containing an <code>iffy:restriction</code> contain a unique restriction. Each <code>iffy:restriction</code> SHOULD apply to nonoverlapping application-specific contexts. If that is not the case, how applications prioritize or respond to conflicting <code>iffy-hint-announce</code> elements whose restrictions both apply must be determined by the application.</p>
240 <h4><a href="#example-2" id="example-2" name="example-2" class="anchorlink"></a>Example:</h4> <h4><a href="#example-4" id="example-4" name="example-4" class="anchorlink"></a>Example:</h4>
241 <pre><code class="language-xml"><iffy:hint-announce> <pre><code class="language-xml"><iffy:hint-announce>
242 <iffy:policy>Piggyback</iffy:policy> <iffy:policy>Piggyback</iffy:policy>
243</iffy:hint-announce></iffy:hint-announce>
⋮⋮⋮
259 <h3><a href="#when-a-subelement-of-item--iffyupdate-history" id="when-a-subelement-of-item--iffyupdate-history" name="when-a-subelement-of-item--iffyupdate-history" class="anchorlink"></a>When a subelement of <code>item</code> > <a href="#iffy-update-history"><code>iffy:update-history</code></a></h3> <h3><a href="#when-a-subelement-of-item--iffyupdate-history" id="when-a-subelement-of-item--iffyupdate-history" name="when-a-subelement-of-item--iffyupdate-history" class="anchorlink"></a>When a subelement of <code>item</code> > <a href="#iffy-update-history"><code>iffy:update-history</code></a></h3>
260 <p>An <code>iffy:initial</code> MAY BE included under <code>item</code> > <a href="#iffy-update-history"><code>iffy:update-history</code></a>, but is recommended ONLY IF the title, authorship, or link have changed.</p> <p>An <code>iffy:initial</code> MAY BE included under <code>item</code> > <a href="#iffy-update-history"><code>iffy:update-history</code></a>, but is recommended ONLY IF the title, authorship, or link have changed.</p>
261 <p>Since <code>item</code> > <code>guid</code> and <code>item</code> > <code>pubDate</code> never change, generators SHOULD NOT include these items under <code>item</code> > <code>iffy:update-history</code>. They are available directly in the containing item.</p> <p>Since <code>item</code> > <code>guid</code> and <code>item</code> > <code>pubDate</code> never change, generators SHOULD NOT include these items under <code>item</code> > <code>iffy:update-history</code>. They are available directly in the containing item.</p>
262 <h4><a href="#example-3" id="example-3" name="example-3" class="anchorlink"></a>Example:</h4> <h4><a href="#example-5" id="example-5" name="example-5" class="anchorlink"></a>Example:</h4>
263 <pre><code class="language-xml"><iffy:initial> <pre><code class="language-xml"><iffy:initial>
264 <!-- Perhaps more recent updates, and the current item, include more authors --> <!-- Perhaps more recent updates, and the current item, include more authors -->
265 <dc:creator>First Author, Esq.</dc:creator> <dc:creator>First Author, Esq.</dc:creator>
⋮⋮⋮
275 <li>If an <code>item</code> > <code>pubDate</code> is defined in the post that was updated, that MUST BE recorded as <code>atom:published</code></li> <li>If an <code>item</code> > <code>pubDate</code> is defined in the post that was updated, that MUST BE recorded as <code>atom:published</code></li>
276 <li>If an <code>item</code> > <code>dc:creator</code> is defined in the post that was updated, that MUST BE recorded as <code>dc:creator</code> If, in the post that was updated, authorship was defined using <code>item</code> > <code>author</code> or <code>item</code> > <code>atom:author</code> those items should be converted into a form appropriate for <code>dc:creator</code> elements.</li> <li>If an <code>item</code> > <code>dc:creator</code> is defined in the post that was updated, that MUST BE recorded as <code>dc:creator</code> If, in the post that was updated, authorship was defined using <code>item</code> > <code>author</code> or <code>item</code> > <code>atom:author</code> those items should be converted into a form appropriate for <code>dc:creator</code> elements.</li>
277 </ul> </ul>
278 <h4><a href="#example-4" id="example-4" name="example-4" class="anchorlink"></a>Example:</h4> <h4><a href="#example-6" id="example-6" name="example-6" class="anchorlink"></a>Example:</h4>
279 <pre><code class="language-xml"><item> <pre><code class="language-xml"><item>
280 <pubDate>Thu, 20 Jun 2024 13:10:00 -0400</pubDate> <pubDate>Thu, 20 Jun 2024 13:10:00 -0400</pubDate>
281 <guid isPermalink="true"> <guid isPermalink="true">
⋮⋮⋮
379 <p>Please see <a href="#iffy-hint-announce"><code>iffy:hint-announce</code></a>.</p> <p>Please see <a href="#iffy-hint-announce"><code>iffy:hint-announce</code></a>.</p>
380 </div> </div>
381 <hr> <hr>
382 <h2><a href="#element--iffyrecent-" id="element--iffyrecent-" name="element--iffyrecent-" class="anchorlink"></a>Element — <code>iffy:recent</code> <a id="iffy-recent" href=""></a></h2>
383 <div class="iffy-element-desc">
384 <h3><a href="#when-beneath-iffycuration-1" id="when-beneath-iffycuration-1" name="when-beneath-iffycuration-1" class="anchorlink"></a>When beneath <a href="#iffy-curation"><code>iffy:curation</code></a></h3>
385 <p><code>iffy:recent</code> is a <em>curation type</em>, a description of how the feed is curated relative to the body of work a subset of which it presents.</p>
386 <p>Curation type <code>iffy:recent</code> signifies that a subset consisting of the most work is represented by <code>item</code> elements in this feed.</p>
387 <p>(Curations of logically of type recent represent the most common use-case for RSS, although most feeds do not yet annotate themselves as such.)</p>
388 <p><code>iffy:recent</code> has three attributes:</p>
389 <ul>
390 <li>
391 <p><code>last</code> — When the attribute <code>last="<positive-integer-value-n>"</code> is defined, the feed displays a subset of the most recent <code>n</code> items, if there are at least <code>n</code> items in the unabridged body of work.</p></li>
392 <li>
393 <p><code>since</code> — When the attribute <code>since="<timestamp>"</code> is defined, all elements more recent than the given timestamp are represented as items in this feed. Timestamps may de defined as <a href="https://datatracker.ietf.org/doc/html/rfc4287#section-3.3">atom "date constructs"</a> OR in the format expected for <a href="https://www.rssboard.org/rss-specification"><code>pubDate</code> in standard RSS</a>.</p></li>
394 <li>
395 <p><code>operation</code> — Values must be one of <code>and</code> or <code>or</code>. Determines whether, if both <code>last</code> and <code>since</code> are set, items must be more recent than the <code>since</code> timestamp AND among the most recent <code>n</code> defined by <code>last</code>, or whether all items more recent than the <code>since</code> timestamp OR among the most recent <code>n</code> defined by <code>last</code> are included. If no <code>operation</code> is set, and both <code>last</code> and <code>since</code> are set, then <code>operation</code> should be presumed to default to <code>and</code>.</p></li>
396 </ul>
397 <h4><a href="#example-7" id="example-7" name="example-7" class="anchorlink"></a>Example:</h4>
398 <pre><code class="language-xml"><?xml version='1.0' encoding='UTF-8'?>
399
400<rss version="2.0" xmlns:iffy="http://tech.interfluidity.com/xml/iffy/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/">
401 <channel>
402 <title>tech — interfluidity</title>
403 <atom:link type="application/rss+xml" rel="self" href="https://tech.interfluidity.com/feed/index.rss"/>
404 <iffy:curation>
405 <iffy:recent since="2024-08-16T22:22:14.297722-04:00" last="10" operator="and"/>
406 </iffy:curation>
407 <!-- Other channel elements -->
408 <item>
409 <!-- Other item elements -->
410 </item>
411 </channel>
412</rss>
413</code></pre>
414 </div>
415 <hr>
416 <h2><a href="#element--iffyrevision-" id="element--iffyrevision-" name="element--iffyrevision-" class="anchorlink"></a>Element — <code>iffy:revision</code> <a id="iffy-revision" href=""></a></h2> <h2><a href="#element--iffyrevision-" id="element--iffyrevision-" name="element--iffyrevision-" class="anchorlink"></a>Element — <code>iffy:revision</code> <a id="iffy-revision" href=""></a></h2>
417 <div class="iffy-element-desc"> <div class="iffy-element-desc">
418 <p>MUST contain a URL, URI, or <a href="https://datatracker.ietf.org/doc/html/rfc3987">IRI</a> of a either a fixed past revision or the current (potentially evolving) revision of an item.</p> <p>MUST contain a URL, URI, or <a href="https://datatracker.ietf.org/doc/html/rfc3987">IRI</a> of a either a fixed past revision or the current (potentially evolving) revision of an item.</p>
⋮⋮⋮
422 <p>See <a href="#iffy-update-history"><code>iffy:update-history</code> example</a>.</p> <p>See <a href="#iffy-update-history"><code>iffy:update-history</code> example</a>.</p>
423 </div> </div>
424 <hr> <hr>
425 <h2><a href="#element--iffyselection-" id="element--iffyselection-" name="element--iffyselection-" class="anchorlink"></a>Element — <code>iffy:selection</code> <a id="iffy-selection" href=""></a></h2>
426 <div class="iffy-element-desc">
427 <h3><a href="#when-beneath-iffycuration-2" id="when-beneath-iffycuration-2" name="when-beneath-iffycuration-2" class="anchorlink"></a>When beneath <a href="#iffy-curation"><code>iffy:curation</code></a></h3>
428 <p><code>iffy:selection</code> is a <em>curation type</em>, a description of how the feed is curated relative to the body of work a subset of which it presents.</p>
429 <p>Curation type <code>iffy:selection</code> signifies that this feed is the result of a potentially arbitrary query against or restriction of the full body of work.</p>
430 <p>An <code>iffy:selection</code> tag SHOULD contain subelements, documenting the query or restriction that produced this selection, ideally with sufficient information to reproduce the selection from a specified upstream source.</p>
431 <p>However, no standard yet described how queries and restrictions might be document. For now, it is a playground for developer creativity...</p>
432 <h4><a href="#example-8" id="example-8" name="example-8" class="anchorlink"></a>Example:</h4>
433 <pre><code class="language-xml"><?xml version='1.0' encoding='UTF-8'?>
434
435<rss version="2.0" xmlns:iffy="http://tech.interfluidity.com/xml/iffy/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/">
436 <channel>
437 <title>tech — interfluidity</title>
438 <atom:link type="application/rss+xml" rel="self" href="https://tech.interfluidity.com/feed/index.rss"/>
439 <iffy:curation>
440 <iffy:selection>
441 <acme:query> <!-- totally faking it here -->
442 <acme:dbhost>articles.zine.dk</acme:dbhost>
443 <acme:dbport>5432</acme:dbhost>
444 <acme:sql>SELECT article_id FROM article WHERE author = 'Jane Doe'</acme:sql>
445 </acme:query>
446 </iffy:selection>
447 </iffy:curation>
448 <!-- Other channel elements -->
449 <item>
450 <!-- Other item elements -->
451 </item>
452 </channel>
453</rss>
454</code></pre>
455 </div>
456 <hr>
457 <h2><a href="#element--iffysingle-" id="element--iffysingle-" name="element--iffysingle-" class="anchorlink"></a>Element — <code>iffy:single</code> <a id="iffy-single" href=""></a></h2>
458 <div class="iffy-element-desc">
459 <h3><a href="#when-beneath-iffycuration-3" id="when-beneath-iffycuration-3" name="when-beneath-iffycuration-3" class="anchorlink"></a>When beneath <a href="#iffy-curation"><code>iffy:curation</code></a></h3>
460 <p><code>iffy:single</code> is a <em>curation type</em>, a description of how the feed is curated relative to the body of work a subset of which it presents.</p>
461 <p>Curation type <code>iffy:single</code> signifies that this is <a href="../../2024/11/12/supporting-single-item-rss/index.html">single-item RSS</a>.</p>
462 <p>The feed contains just one item, not by happenstance because there is only one recent item, nor because some <a href="#iffy-selection">selection</a> yielded just one item, but intentionally, so that metadata related to the item can have its own permanent RSS home.</p>
463 <h4><a href="#example-9" id="example-9" name="example-9" class="anchorlink"></a>Example:</h4>
464 <pre><code class="language-xml"><?xml version='1.0' encoding='UTF-8'?>
465
466<rss version="2.0" xmlns:iffy="http://tech.interfluidity.com/xml/iffy/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/">
467 <channel>
468 <title>tech — interfluidity</title>
469 <atom:link type="application/rss+xml" rel="self" href="https://tech.interfluidity.com/feed/index.rss"/>
470 <iffy:curation>
471 <iffy:single/>
472 </iffy:curation>
473 <!-- Other channel elements -->
474 <item>
475 <!-- Other item elements -->
476 </item>
477 </channel>
478</rss>
479</code></pre>
480 </div>
481 <hr>
482 <h2><a href="#element--iffysynthetic-" id="element--iffysynthetic-" name="element--iffysynthetic-" class="anchorlink"></a>Element — <code>iffy:synthetic</code> <a id="iffy-synthetic" href=""></a></h2> <h2><a href="#element--iffysynthetic-" id="element--iffysynthetic-" name="element--iffysynthetic-" class="anchorlink"></a>Element — <code>iffy:synthetic</code> <a id="iffy-synthetic" href=""></a></h2>
483 <div class="iffy-element-desc"> <div class="iffy-element-desc">
484 <p>This element marks channels or items that are in some sense automated or "synthetic".</p> <p>This element marks channels or items that are in some sense automated or "synthetic".</p>
⋮⋮⋮
491 </ul> </ul>
492 <h3><a href="#when-a-subelement-of-channel-and-iffytype-is-itemupdatefeed" id="when-a-subelement-of-channel-and-iffytype-is-itemupdatefeed" name="when-a-subelement-of-channel-and-iffytype-is-itemupdatefeed" class="anchorlink"></a>When a subelement of <code>channel</code> AND <a href="#iffy-type"><code>iffy:type</code></a> is <code>ItemUpdateFeed</code></h3> <h3><a href="#when-a-subelement-of-channel-and-iffytype-is-itemupdatefeed" id="when-a-subelement-of-channel-and-iffytype-is-itemupdatefeed" name="when-a-subelement-of-channel-and-iffytype-is-itemupdatefeed" class="anchorlink"></a>When a subelement of <code>channel</code> AND <a href="#iffy-type"><code>iffy:type</code></a> is <code>ItemUpdateFeed</code></h3>
493 <p>SHOULD 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> <p>SHOULD 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>
494 <h4><a href="#example-5" id="example-5" name="example-5" class="anchorlink"></a>Example:</h4> <h4><a href="#example-10" id="example-10" name="example-10" class="anchorlink"></a>Example:</h4>
495 <pre><code class="language-xml"> <channel> <pre><code class="language-xml"> <channel>
496 <!-- other channel elements --> <!-- other channel elements -->
497 <iffy:synthetic> <iffy:synthetic>
⋮⋮⋮
510 </ul> </ul>
511 <h3><a href="#when-a-subelement-of-item-and-iffytype-is-updateannouncement" id="when-a-subelement-of-item-and-iffytype-is-updateannouncement" name="when-a-subelement-of-item-and-iffytype-is-updateannouncement" class="anchorlink"></a>When a subelement of <code>item</code> AND <a href="#iffy-type"><code>iffy:type</code></a> is <code>UpdateAnnouncement</code></h3> <h3><a href="#when-a-subelement-of-item-and-iffytype-is-updateannouncement" id="when-a-subelement-of-item-and-iffytype-is-updateannouncement" name="when-a-subelement-of-item-and-iffytype-is-updateannouncement" class="anchorlink"></a>When a subelement of <code>item</code> AND <a href="#iffy-type"><code>iffy:type</code></a> is <code>UpdateAnnouncement</code></h3>
512 <p>In addition to <code>iffy:type</code>, MUST contain an <a href="#iffy-update"><code>iffy:update</code></a> element, which in turn MUST contain an <a href="#iffy-initial"><code>iffy:initial</code></a> element describing the initial state of the updated post.</p> <p>In addition to <code>iffy:type</code>, MUST contain an <a href="#iffy-update"><code>iffy:update</code></a> element, which in turn MUST contain an <a href="#iffy-initial"><code>iffy:initial</code></a> element describing the initial state of the updated post.</p>
513 <h4><a href="#example-6" id="example-6" name="example-6" class="anchorlink"></a>Example:</h4> <h4><a href="#example-11" id="example-11" name="example-11" class="anchorlink"></a>Example:</h4>
514 <pre><code class="language-xml"><item> <pre><code class="language-xml"><item>
515 <pubDate>Thu, 20 Jun 2024 13:10:00 -0400</pubDate> <pubDate>Thu, 20 Jun 2024 13:10:00 -0400</pubDate>
516 <guid isPermalink="true"> <guid isPermalink="true">
⋮⋮⋮
678 <div class="entry-footer"> <div class="entry-footer">
679 <div class="post-metainfo"> <div class="post-metainfo">
680 <div class="updated-note"> <div class="updated-note">
681 <a href="index.html#major-updates">Last major update at 2024-11-02 @ 05:15 PM EDT</a> <a href="index.html#major-updates">Last major update at 2024-11-15 @ 01:10 AM EST</a>
682 </div> </div>
683 <div> <div>
684 <a href="index.html" class="pubtime">04:10 AM EDT</a> <a href="index.html" class="pubtime">04:10 AM EDT</a>
⋮⋮⋮
701 <div id="update-history" class="update-history"> <div id="update-history" class="update-history">
702 <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>
703 <ul> <ul>
704 <li><span class="update-timestamp"><i>2024-11-02 @ 05:15 PM EDT</i></span> — Clarifications of iffy:provenance and iffy:update-history. (<a href="index-diff-34d8dab8f187c6d9512615dbb83c95395aa49a3b-to-current.html">diff</a>)</li> <li><span class="update-timestamp"><i>2024-11-15 @ 01:10 AM EST</i></span> — Document <code>iffy:curation</code>, and curation type elements <code>iffy:all</code>, <code>iffy:recent</code>, <code>iffy:selection</code>, <code>iffy:single</code>. (<a href="index-diff-5fcd99373d2d940a0c6e1468979be59e2d6bcced-to-current.html">diff</a>)</li>
705 <li><span class="update-timestamp"><i> <a href="index-oldcommit-5fcd99373d2d940a0c6e1468979be59e2d6bcced.html">2024-11-02 @ 05:15 PM EDT</a></i></span> — Clarifications of iffy:provenance and iffy:update-history. (<a href="index-diff-34d8dab8f187c6d9512615dbb83c95395aa49a3b-to-5fcd99373d2d940a0c6e1468979be59e2d6bcced.html">diff</a>)</li>
706 <li><span class="update-timestamp"><i> <a href="index-oldcommit-34d8dab8f187c6d9512615dbb83c95395aa49a3b.html">2024-07-01 @ 02:40 PM EDT</a></i></span> — Major revision of <code>iffy:synthetic</code>, generalize <code>iffy:initial</code>, <code>iffy:update</code>, <code>iffy:update-history</code>, define <code>iffy:uid</code>. (<a href="index-diff-0df7787c056ab2b983e2de4d107c2fa477b7c8f4-to-34d8dab8f187c6d9512615dbb83c95395aa49a3b.html">diff</a>)</li> <li><span class="update-timestamp"><i> <a href="index-oldcommit-34d8dab8f187c6d9512615dbb83c95395aa49a3b.html">2024-07-01 @ 02:40 PM EDT</a></i></span> — Major revision of <code>iffy:synthetic</code>, generalize <code>iffy:initial</code>, <code>iffy:update</code>, <code>iffy:update-history</code>, define <code>iffy:uid</code>. (<a href="index-diff-0df7787c056ab2b983e2de4d107c2fa477b7c8f4-to-34d8dab8f187c6d9512615dbb83c95395aa49a3b.html">diff</a>)</li>
707 <li><span class="update-timestamp"><i> <a href="index-oldcommit-0df7787c056ab2b983e2de4d107c2fa477b7c8f4.html">2024-06-20 @ 11:05 AM EDT</a></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-0df7787c056ab2b983e2de4d107c2fa477b7c8f4.html">diff</a>)</li> <li><span class="update-timestamp"><i> <a href="index-oldcommit-0df7787c056ab2b983e2de4d107c2fa477b7c8f4.html">2024-06-20 @ 11:05 AM EDT</a></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-0df7787c056ab2b983e2de4d107c2fa477b7c8f4.html">diff</a>)</li>
708 <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> <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>
⋮⋮⋮
714 <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>
715 </ul> </ul>
716 <div class="update-history-note"> <div class="update-history-note">
717 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-11-10 @ 08:30 PM EST. 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-11-15 @ 01:09 AM EST.
718 </div> </div>
719 </div> </div>
720</div><!-- after-article --></div><!-- after-article -->
⋮⋮⋮
724 </div> </div>
725 </body> </body>
726</html></html>