Line | 6c5fef82527bd419e8e9c7e7f3a6420c9925cf10 | b8f2ae57694f9fb88b10df011f69ee9acfe4c0ac |
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> |