Diff of /xml/iffy/index.html

Revision 199e44561de3fd9e731a335d8b2a655f42d9bc04 => current


Line199e44561de3fd9e731a335d8b2a655f42d9bc04current
1<!DOCTYPE html><!DOCTYPE html>
2<html><html>
3 <head> <head>
50 <hr class="below-title"> <hr class="below-title">
51 </div> </div>
52 <div class="update-prepend rss-description-exclude"> <div class="update-prepend rss-description-exclude">
53 <em> ➣  This post was meaningfully revised at 2024-06-01 @ 09:35 PM EDT. The previous revision is <a href="index-oldcommit-72eaf9fdfebc9e627bff33bbe1102d4d250ad1d0.html">here</a>. (See <a href="index.html#update-history">update history</a>.) <br> <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>
54 ➣  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>.
55 <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>
56 <hr> <hr>
57 </div> </div>
70 <li><a href="#iffy-initial"><code>iffy:initial</code></a></li> <li><a href="#iffy-initial"><code>iffy:initial</code></a></li>
71 <li><a href="#iffy-provenance"><code>iffy:provenance</code></a></li> <li><a href="#iffy-provenance"><code>iffy:provenance</code></a></li>
72 <li><a href="#iffy-revision"><code>iffy:revision</code></a></li> <li><a href="#iffy-revision"><code>iffy:revision</code></a></li>
73 <li><a href="#iffy-timestamp"><code>iffy:timestamp</code></a></li>
74 <li><a href="#iffy-update"><code>iffy:update</code></a></li> <li><a href="#iffy-update"><code>iffy:update</code></a></li>
75 <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>
76 </ul> </ul>
184 <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>
185 </div> </div>
186 <hr> <hr>
187 <p><a id="iffy-timestamp" href=""></a><strong>Element — <code>iffy:timestamp</code></strong></p>
188 <div class="iffy-element-desc">
189 <p>MUST contain an <a href="https://datatracker.ietf.org/doc/html/rfc3339">RFC3339</a> date-time construction.</p>
190 <p>Formatting and constraints are identical to those described for <a href="https://datatracker.ietf.org/doc/html/rfc4287#section-3.3">atom date constructs</a>.</p>
191 <p><strong>Example</strong>:</p>
192 <pre><code class="language-xml"><iffy:timestamp>2003-12-13T18:30:02Z</iffy:timestamp>
193<iffy:timestamp>2003-12-13T18:30:02+01:00</iffy:timestamp>
194</code></pre>
195 <p>See also <a href="#iffy-update-history"><code>iffy:update-history</code> example</a>.</p>
196 </div>
197 <hr>
198 <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>
199 <div class="iffy-element-desc"> <div class="iffy-element-desc">
200 <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>
201 <p>MUST contain one <a href="#iffy-timestamp"><code>iffy:timestamp</code></a> element.</p> <p>MUST contain one <a href="https://datatracker.ietf.org/doc/html/rfc4287#section-4.2.15"><code>atom:updated</code></a> element.</p>
202 <p>MAY also contain one each of</p> <p>MAY also contain one each of</p>
203 <ul> <ul>
204 <li><a href="https://datatracker.ietf.org/doc/html/rfc4287#section-4.2.13"><code>atom:summary</code></a></li> <li><a href="https://datatracker.ietf.org/doc/html/rfc4287#section-4.2.13"><code>atom:summary</code></a></li>
216 <p>SHOULD contain a sequence of <a href="#iffy-update"><code>iffy:update</code></a> elements, in reverse chronological order, describing the histories of <em>major revisions</em> to an item.</p> <p>SHOULD contain a sequence of <a href="#iffy-update"><code>iffy:update</code></a> elements, in reverse chronological order, describing the histories of <em>major revisions</em> to an item.</p>
217 <p>MAY contain one <a href="#iffy-initial"><code>iffy:initial</code></a> element.</p> <p>MAY contain one <a href="#iffy-initial"><code>iffy:initial</code></a> element.</p>
218 <p>Items containing an <code>iffy:update-history</code> SHOULD also include an <a href="https://datatracker.ietf.org/doc/html/rfc4287#section-4.2.15"><code>atom:updated</code></a> tag corresponding to the most recent update.</p> <p>Items containing an <code>iffy:update-history</code> SHOULD also include an <a href="https://datatracker.ietf.org/doc/html/rfc4287#section-4.2.15"><code>atom:updated</code></a> tag corresponding to the most recent update.</p>
219 <p><strong><em>Typo fixes, small rephrasings, and other minor tweaks need not be recorded as distinct updates. That is, within a "single update" there may be a sequence of smaller revisions that go unrecorded.</em></strong> Applications that want a more forensic history might consider including and exposing every published change in version control.</p> <p><strong><em>Typo fixes, small rephrasings, and other minor tweaks are not expected to be recorded as distinct updates. That is, within a "single update" there may be a sequence of smaller revisions that go unrecorded.</em></strong> Applications that want a more forensic history might consider including and exposing every published change in version control.</p>
220 <p><a id="iffy-update-history-example" href=""></a><strong>Example</strong>:</p> <p><a id="iffy-update-history-example" href=""></a><strong>Example</strong>:</p>
221 <pre><code class="language-xml"><item> <pre><code class="language-xml"><item>
222 <!-- Other item elements -->
223 <iffy:update-history> <iffy:update-history>
224 <iffy:update> <iffy:update>
225 <iffy:timestamp>2024-06-02T03:00:00Z</iffy:timestamp> <atom:updated>2024-06-02T04:20:00Z</atom:updated>
226 <atom:summary><![CDATA[Add tags related to updates and revisions.]]></atom:summary> <atom:summary>
227 <![CDATA[Drop <code>iffy:timestamp</code>. We can just reuse <code>atom:updated</code> for the same work.]]>
228 </atom:summary>
229 <iffy:revision> <iffy:revision>
230 https://tech.interfluidity.com/xml/iffy/index-oldcommit-199e44561de3fd9e731a335d8b2a655f42d9bc04.html
231 </iffy:revision>
232 <iffy:diff>
233 https://tech.interfluidity.com/xml/iffy/index-diff-199e44561de3fd9e731a335d8b2a655f42d9bc04-to-current.html
234 </iffy:diff>
235 </iffy:update>
236 <iffy:update>
237 <atom:updated>2024-06-02T01:35:00Z</atom:updated>
238 <atom:summary><![CDATA[Add initial take on tags related to updates and revisions.]]></atom:summary>
239 <iffy:revision>
240 https://tech.interfluidity.com/xml/iffy/index-oldcommit-72eaf9fdfebc9e627bff33bbe1102d4d250ad1d0.html https://tech.interfluidity.com/xml/iffy/index-oldcommit-72eaf9fdfebc9e627bff33bbe1102d4d250ad1d0.html
241 </iffy:revision> </iffy:revision>
242 <iffy:diff> <iffy:diff>
243 https://tech.interfluidity.com/xml/iffy/index-diff-72eaf9fdfebc9e627bff33bbe1102d4d250ad1d0-to-current.html https://tech.interfluidity.com/xml/iffy/index-diff-72eaf9fdfebc9e627bff33bbe1102d4d250ad1d0-to-199e44561de3fd9e731a335d8b2a655f42d9bc04.html
244 </iffy:diff> </iffy:diff>
245 </iffy:update> </iffy:update>
246 <iffy:update> <iffy:update>
247 <iffy:timestamp>2024-05-26T03:00:00Z</iffy:timestamp> <atom:updated>2024-05-26T03:00:00Z</atom:updated>
248 <atom:summary><![CDATA[Add JS/CSS so that prior revisions are visually distinct from current.]]></atom:summary> <atom:summary><![CDATA[Add JS/CSS so that prior revisions are visually distinct from current.]]></atom:summary>
249 <iffy:revision> <iffy:revision>
250 https://tech.interfluidity.com/xml/iffy/index-oldcommit-13de0232319ceab2f830591c318089d18cbec78d.html https://tech.interfluidity.com/xml/iffy/index-oldcommit-13de0232319ceab2f830591c318089d18cbec78d.html
254 </iffy:diff> </iffy:diff>
255 </iffy:update> </iffy:update>
256 <iffy:update> <iffy:update>
257 <iffy:timestamp>2024-05-24T04:25:00Z</iffy:timestamp> <atom:updated>2024-05-24T04:25:00Z</atom:updated>
258 <atom:summary> <atom:summary>
259 <![CDATA[Drop tags <code>iffy:when-updated</code> and <code>iffy:original-guid</code>, bad appraoch to updates.]]> <![CDATA[Drop tags <code>iffy:when-updated</code> and <code>iffy:original-guid</code>, bad appraoch to updates.]]>
260 </atom:summary> </atom:summary>
275 <div class="post-metainfo"> <div class="post-metainfo">
276 <a href="index.html">04:10 AM EDT</a> <a href="index.html">04:10 AM EDT</a>
277 <div class="updated-note"> <div class="updated-note">
278 <a href="index.html#major-updates">Last major update at 2024-06-01 @ 09:35 PM EDT</a> <a href="index.html#major-updates">Last major update at 2024-06-02 @ 12:25 AM EDT</a>
279 </div> </div>
280 </div> </div>
281 </div> </div>
289 <a href="../../index.html">↑↑↑</a> <a href="../../index.html">↑↑↑</a>
290 </div> </div>
291 <div class="next"> <div class="next">
292 <a href="../../2024/06/02/green-shoots-of-sprouts/index.html">Green shoots of sprouts →</a>
293 </div> </div>
294 </div> </div>
295 <div id="update-history" class="update-history"> <div id="update-history" class="update-history">
296 <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>
297 <ul> <ul>
298 <li><span class="update-timestamp"><i>2024-06-01 @ 09:35 PM EDT</i></span> — Add initial take on tags related to updates and revisions. (<a href="index-diff-72eaf9fdfebc9e627bff33bbe1102d4d250ad1d0-to-current.html">diff</a>)</li> <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>
299 <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>
300 <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>
301 <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>
302 <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>
312 </div> </div>
313 </body> </body>
314</html></html>