<?xml version="1.0" encoding="UTF-8"?>
<essay xml:lang="en" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:gal="http://norman.walsh.name/rdf/gallery#">
<info>
    
    
    
    
    
    
    
<title>Three Dates for Atom</title><biblioid class="uri">http://norman.walsh.name/2004/03/14/threeDates</biblioid>
<volumenum>7</volumenum>
<issuenum>44</issuenum>
<pubdate>2004-03-14T15:57:00Z</pubdate>
<date>$Date: 2005-09-11 10:27:02 -0400 (Sun, 11 Sep 2005) $</date>
<author>
      <personname>
<firstname>Norman</firstname>
	<surname>Walsh</surname>
</personname>
    </author>
<copyright>
      <year>2004</year>
      <holder>Norman Walsh</holder>
    </copyright>
<abstract>
<para>There have been several long threads on the Atom mailing list
about which dates make sense for an entry and which should be
required. I’ve posted once or twice to the effect that I need only
two: created and modified. I’ve changed my mind, I need a third:
issued.</para>
</abstract>
<dc:subject rdf:resource="http://norman.walsh.name/knows/taxonomy#Atom"/>
</info>

<epigraph>
<attribution>
      <personname>
	<firstname>John</firstname>
<surname>Lithgow</surname>
      </personname>
    </attribution>
<para xml:id="p1">Time sneaks up on you like a windshield on a bug.
</para>
</epigraph>

<para xml:id="p2">There have been several long threads on the Atom
<link xlink:href="http://www.imc.org/atom-syntax/mail-archive/">mailing list</link>
about which dates make sense for an entry and which should be
required. I’ve posted once or twice to the effect that I need only two: created
and modified. I’ve changed my mind, I need a third: issued.</para>

<para xml:id="p3">I used to place entries in my primary
<link xlink:href="http://www.intertwingly.net/wiki/pie/FrontPage">Atom</link> feed,
“<link xlink:href="/atom/whatsnew.xml"/>,” based upon their creation date.
That works fine for new entries, but occasionally I update an existing
entry in a significant way. Because the creation date hasn’t changed,
there’s nothing to draw the readers attention to the modified essay.
What I’d really like is to have it “republished” in my Atom feed.</para>

<para xml:id="p4">My first solution was simply to adopt the modified date as the criteria
for selection. That solves the problem, but it too often draws attention to
essays that aren’t substantively changed. Fixing a typo or updating a URI
counts as modification, but it doesn’t warrant the same level of attention.</para>

<para xml:id="p5">Another possibility would be to update the creation date. The argument,
if I wanted to make it, would be that a significantly modified essay isn’t
really the same as the original and so a new creation date is justified.
Perhaps. But that argument doesn’t move me. My essay about
<link xlink:href="/2003/09/05/plotspam">plotting spam</link> from September, 2003,
didn’t become a new essay just because I added another graph in February, 2004.</para>

<para xml:id="p6">So what I’ve decided to do is add an “issued” date. For most
essays, the issued date and the creation date will be the same. But if
I update an essay in some significant way, I’ll also set a new issued
date. That’s the date that will be (by the time you read this) used to
build the Atom feed.</para>

<para xml:id="p7">I’m not the first to reach this conclusion, the
<link xlink:href="http://www.dublincore.org/documents/dcmi-terms/">DCMI Metadata Terms</link>
already provide just these terms with just these semantics.</para>

<para xml:id="p8">In the Atom specification, I’d be inclined to make “created”
required and “issued” and “modified” optional with the explicit
semantic that if issued isn’t provided, it defaults to the creation
date and, if modified isn’t provided, it defaults to the issued date.
In that way, all entries always have all three dates, irrespective of
what blogging software provides for authors. That should simplify the
lives of aggregators without making the implementors or authors struggle.
</para>

</essay>

