| Line | 6c5fef82527bd419e8e9c7e7f3a6420c9925cf10 | current |
|---|
| 1 | <!DOCTYPE html> | <!DOCTYPE html> |
|---|
| 2 | <html> | <html> |
|---|
| 3 | <head> | <head> |
|---|
| 4 | <meta charset="utf-8"> | <meta charset="utf-8"> |
|---|
| 5 | <meta name="description" content="tech notebook @ interfluidity"> | <meta name="description" content="tech notebook @ interfluidity"> |
|---|
| 6 | <meta name="keywords" content="Scala, tech, interfluidity"> | <meta name="keywords" content="Scala, tech, interfluidity"> |
|---|
| 7 | <meta name="author" content="Steve Randy Waldman"> | <meta name="author" content="Steve Randy Waldman"> |
|---|
| 8 | <meta name="viewport" content="width=device-width, initial-scale=1.0"> | <meta name="viewport" content="width=device-width, initial-scale=1.0"> |
|---|
| 9 | | |
|---|
| 10 | | <!-- icons / favicons --> |
|---|
| 11 | | |
|---|
| 12 | | <!-- we just want the squared-corner image with no overlays for traditional favicon uses at tiny sizes --> |
|---|
| 13 | | <!-- swaldman added, ick, firefox scales down the biggest size for its tab icon, so we use the graphic we want for small sizes as the largest... --> |
|---|
| 14 | | <link rel="icon" type="image/png" sizes="500x500" href="../../icon/interfluidity-wave-blank-square-500x500.png"> |
|---|
| 15 | | <link rel="icon" type="image/png" sizes="32x32" href="../../icon/interfluidity-wave-blank-square-32x32.png"> <!-- swaldman added, for standard favicon size --> |
|---|
| 16 | | <link rel="icon" type="image/png" sizes="16x16" href="../../icon/interfluidity-wave-blank-square-16x16.png"> <!-- swaldman added, for standard favicon size --> |
|---|
| 17 | | <link rel="icon" type="image/png" href="../../icon/interfluidity-wave-blank-square-57x57.png"> <!-- swaldman added, for small icons by default --> |
|---|
| 18 | | |
|---|
| 19 | | <!-- at bigger sizes, we overlay a bit of text --> |
|---|
| 20 | | <!-- icons as recommened by https://mathiasbynens.be/notes/touch-icons --> |
|---|
| 21 | | <!-- For Chrome for Android: --> |
|---|
| 22 | | <link rel="icon" sizes="192x192" href="../../icon/interfluidity-wave-tech-192x192.png"> |
|---|
| 23 | | <!-- For iPhone 6 Plus with @3× display: --> |
|---|
| 24 | | <link rel="apple-touch-icon-precomposed" sizes="180x180" href="../../icon/interfluidity-wave-tech-180x180.png"> |
|---|
| 25 | | <!-- For iPad with @2× display running iOS ≥ 7: --> |
|---|
| 26 | | <link rel="apple-touch-icon-precomposed" sizes="152x152" href="../../icon/interfluidity-wave-tech-152x152.png"> |
|---|
| 27 | | <!-- For iPad with @2× display running iOS ≤ 6: --> |
|---|
| 28 | | <link rel="apple-touch-icon-precomposed" sizes="144x144" href="../../icon/interfluidity-wave-tech-144x144.png"> |
|---|
| 29 | | <!-- For iPhone with @2× display running iOS ≥ 7: --> |
|---|
| 30 | | <link rel="apple-touch-icon-precomposed" sizes="120x120" href="../../icon/interfluidity-wave-tech-120x120.png"> |
|---|
| 31 | | <!-- For iPhone with @2× display running iOS ≤ 6: --> |
|---|
| 32 | | <link rel="apple-touch-icon-precomposed" sizes="114x114" href="../../icon/interfluidity-wave-tech-114x114.png"> |
|---|
| 33 | | <!-- For the iPad mini and the first- and second-generation iPad (@1× display) on iOS ≥ 7: --> |
|---|
| 34 | | <link rel="apple-touch-icon-precomposed" sizes="76x76" href="../../icon/interfluidity-wave-tech-76x76.png"> |
|---|
| 35 | | <!-- For the iPad mini and the first- and second-generation iPad (@1× display) on iOS ≤ 6: --> |
|---|
| 36 | | <link rel="apple-touch-icon-precomposed" sizes="72x72" href="../../icon/interfluidity-wave-tech-72x72.png"> |
|---|
| 37 | | <!-- For non-Retina iPhone, iPod Touch, and Android 2.1+ devices: --> |
|---|
| 38 | | <link rel="apple-touch-icon-precomposed" href="../../icon/interfluidity-wave-blank-square-57x57.png"> |
|---|
| 39 | | |
|---|
| 40 | | <!-- end icons / favicons --> |
|---|
| 41 | | |
|---|
| 42 | <link rel="alternate" type="application/rss+xml" title="tech.interfluidity.com updates" href="../../feed/index.rss"> | <link rel="alternate" type="application/rss+xml" title="tech.interfluidity.com updates" href="../../feed/index.rss"> |
|---|
| 43 | <link rel="alternate" type="application/rss+xml" title="interfluidity - all blogs" href="https://www.interfluidity.com/unify-rss/all-blogs.rss"> | <link rel="alternate" type="application/rss+xml" title="interfluidity - all blogs" href="https://www.interfluidity.com/unify-rss/all-blogs.rss"> |
|---|
| 44 | <link rel="alternate" type="application/rss+xml" title="interfluidity - all blogs and microblogs" href="https://www.interfluidity.com/unify-rss/all-blogs-and-microblogs.rss"> | <link rel="alternate" type="application/rss+xml" title="interfluidity - all blogs and microblogs" href="https://www.interfluidity.com/unify-rss/all-blogs-and-microblogs.rss"> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 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-02 @ 12:25 AM EDT. The previous revision is <a href="index-oldcommit-199e44561de3fd9e731a335d8b2a655f42d9bc04.html">here</a>. (See <a href="index.html#update-history">update history</a>.) <br> | <em> ➣ This post was meaningfully revised at 2024-06-11 @ 02:10 PM EDT. The previous revision is <a href="index-oldcommit-6c5fef82527bd419e8e9c7e7f3a6420c9925cf10.html">here</a>, diff <a href="index-diff-6c5fef82527bd419e8e9c7e7f3a6420c9925cf10-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> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 100 | <ul> | <ul> |
|---|
| 101 | <li><a href="#iffy-completeness"><code>iffy:completeness</code></a></li> | <li><a href="#iffy-completeness"><code>iffy:completeness</code></a></li> |
|---|
| 102 | <li><a href="#iffy-diff"><code>iffy:diff</code></a></li> | <li><a href="#iffy-diff"><code>iffy:diff</code></a></li> |
|---|
| 103 | | <li><a href="#iffy-hint-announce"><code>iffy:hint-announce</code></a></li> |
|---|
| 104 | <li><a href="#iffy-initial"><code>iffy:initial</code></a></li> | <li><a href="#iffy-initial"><code>iffy:initial</code></a></li> |
|---|
| 105 | | <li><a href="#iffy-policy"><code>iffy:policy</code></a></li> |
|---|
| 106 | <li><a href="#iffy-provenance"><code>iffy:provenance</code></a></li> | <li><a href="#iffy-provenance"><code>iffy:provenance</code></a></li> |
|---|
| 107 | | <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-update"><code>iffy:update</code></a></li> | <li><a href="#iffy-update"><code>iffy:update</code></a></li> |
|---|
| 110 | <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> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 162 | <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> |
|---|
| 163 | </div> | </div> |
|---|
| 164 | <hr> | <hr> |
|---|
| 165 | | <p><a id="iffy-hint-announce" href=""></a><strong>Element — <code>iffy:hint-announce</code></strong></p> |
|---|
| 166 | | <div class="iffy-element-desc"> |
|---|
| 167 | | <p><strong>When a subelement of <code>item</code></strong></p> |
|---|
| 168 | | <p>Represents a <em>hint</em> to RSS consumers that "push" — announce, rebroadcast, or notify — items whether this item should be so pushed. Consumers are free to ignore this hint or make use of it as they wish.</p> |
|---|
| 169 | | <p>MUST contain an <a href="#iffy-policy"><code>iffy:policy</code></a> element, whose values MUST BE one of</p> |
|---|
| 170 | | <ul> |
|---|
| 171 | | <li><code>Always</code> — the item should always be notified</li> |
|---|
| 172 | | <li><code>Never</code> — the item should never be notified</li> |
|---|
| 173 | | <li><code>Piggyback</code> — the item should be notified as part of digests or other announcements of multiple items, but should not constitute its own announcement.</li> |
|---|
| 174 | | </ul> |
|---|
| 175 | | <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> |
|---|
| 176 | | <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> |
|---|
| 177 | | <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> |
|---|
| 178 | | <p><strong>Example</strong>:</p> |
|---|
| 179 | | <pre><code class="language-xml"><iffy:hint-announce> |
|---|
| 180 | | <iffy:policy>Piggyback</iffy:policy> |
|---|
| 181 | | </iffy:hint-announce> |
|---|
| 182 | | </code></pre> |
|---|
| 183 | | </div> |
|---|
| 184 | | <hr> |
|---|
| 185 | <p><a id="iffy-initial" href=""></a><strong>Element — <code>iffy:initial</code></strong></p> | <p><a id="iffy-initial" href=""></a><strong>Element — <code>iffy:initial</code></strong></p> |
|---|
| 186 | <div class="iffy-element-desc"> | <div class="iffy-element-desc"> |
|---|
| 187 | <p><strong>When a subelement of <a href="#iffy-update-history"><code>iffy:update-history</code></a></strong></p> | <p><strong>When a subelement of <a href="#iffy-update-history"><code>iffy:update-history</code></a></strong></p> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 194 | </code></pre> | </code></pre> |
|---|
| 195 | </div> | </div> |
|---|
| 196 | <hr> | <hr> |
|---|
| 197 | | <p><a id="iffy-policy" href=""></a><strong>Element — <code>iffy:policy</code></strong></p> |
|---|
| 198 | | <div class="iffy-element-desc"> |
|---|
| 199 | | <p>In general, represents a statement of some kind of policy with respect to its containing element, suggested to feed consumers for handling a feed or item.</p> |
|---|
| 200 | | <p><strong>When a subelement of <a href="#iffy-hint-announce"><code>iffy:hint-announce</code></a></strong></p> |
|---|
| 201 | | <p>Please see <a href="#iffy-hint-announce"><code>iffy:hint-announce</code></a>.</p> |
|---|
| 202 | | </div> |
|---|
| 203 | | <hr> |
|---|
| 204 | <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> |
|---|
| 205 | <div class="iffy-element-desc"> | <div class="iffy-element-desc"> |
|---|
| 206 | <p><strong>When an item level element</strong></p> | <p><strong>When an item level element</strong></p> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 237 | </code></pre> | </code></pre> |
|---|
| 238 | </div> | </div> |
|---|
| 239 | <hr> | <hr> |
|---|
| 240 | | <p><a id="iffy-restriction" href=""></a><strong>Element — <code>iffy:restriction</code></strong></p> |
|---|
| 241 | | <div class="iffy-element-desc"> |
|---|
| 242 | | <p>In general, represents an expressin of some kind of restriction over the application of its containing element.</p> |
|---|
| 243 | | <p><strong>When a subelement of <a href="#iffy-hint-announce"><code>iffy:hint-announce</code></a></strong></p> |
|---|
| 244 | | <p>Please see <a href="#iffy-hint-announce"><code>iffy:hint-announce</code></a>.</p> |
|---|
| 245 | | </div> |
|---|
| 246 | | <hr> |
|---|
| 247 | <p><a id="iffy-revision" href=""></a><strong>Element — <code>iffy:revision</code></strong></p> | <p><a id="iffy-revision" href=""></a><strong>Element — <code>iffy:revision</code></strong></p> |
|---|
| 248 | <div class="iffy-element-desc"> | <div class="iffy-element-desc"> |
|---|
| 249 | <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> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 333 | <div class="post-metainfo"> | <div class="post-metainfo"> |
|---|
| 334 | <a href="index.html">04:10 AM EDT</a> | <a href="index.html">04:10 AM EDT</a> |
|---|
| 335 | <div class="updated-note"> | <div class="updated-note"> |
|---|
| 336 | <a href="index.html#major-updates">Last major update at 2024-06-02 @ 12:25 AM EDT</a> | <a href="index.html#major-updates">Last major update at 2024-06-11 @ 02:10 PM EDT</a> |
|---|
| 337 | </div> | </div> |
|---|
| 338 | </div> | </div> |
|---|
| 339 | </div> | </div> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 353 | <div id="update-history" class="update-history"> | <div id="update-history" class="update-history"> |
|---|
| 354 | <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> |
|---|
| 355 | <ul> | <ul> |
|---|
| 356 | <li><span class="update-timestamp"><i>2024-06-02 @ 12:25 AM EDT</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-current.html">diff</a>)</li> | <li><span class="update-timestamp"><i>2024-06-11 @ 02:10 PM EDT</i></span> — Document <code>iffy:hint-announce</code>, <code>iffy:policy</code>, and <code>iffy:restriction</code>. (<a href="index-diff-6c5fef82527bd419e8e9c7e7f3a6420c9925cf10-to-current.html">diff</a>)</li> |
|---|
| 357 | | <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> |
|---|
| 358 | <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> |
|---|
| 359 | <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> |
|---|
| 360 | <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> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 371 | </div> | </div> |
|---|
| 372 | </body> | </body> |
|---|
| 373 | </html> | </html> |
|---|