disast.rs :: how do I rss?

how to rss?

a sample rss file looks like this: (pulled from todepond dot com)

<rss version="2.0">
  <channel>
    <title>Todepond dot com</title>
    <link>http://www.todepond.com/</link>
    <description>place for todes - ribbits aplenty</description>
    <item>
      <title>It’s weird when people recognise me</title>
      <pubDate>Tue, 05 Nov 2024 00:38:00 GMT</pubDate>
      <link> https://www.todepond.com/wikiblogarden/social-media/para/meeting/ </link>
      <guid> https://www.todepond.com/wikiblogarden/social-media/para/meeting/ </guid>
      <description> I am increasingly exposed to people knowing who I am when I attend events. It’s weird. </description>
    </item>
    . . .
    <item>
      <title>Talk season is over</title>
      <pubDate>Tue, 29 Oct 2024 12:57:00 GMT</pubDate>
      <link>https://www.todepond.com/talk/season/over</link>
      <guid>https://www.todepond.com/talk/season/over</guid>
      <description> I gave five talks in a month. Here's the full write-up. </description>
    </item>
  </channel>
</rss>

so, maybe an rss file has a schema like this?:

rss
  channel
    title
    link
    description
    item[]
      title
      pubDate
      link
      guid
      description

so, let's try a first-pass at my own rss feed:

<rss version="2.0">
  <channel>
    <title>DISASTRS!</title>
    <link>https://disast.rs</link>
    <description>DISASTRS</description>
    <item>
      <title>How do I rss?</title>
      <pubDate>2024-11-12 13:12 CST</pubDate>
      <link>https://disast.rs/notes/how-to-rss.html</link>
      <guid>https://disast.rs/notes/how-to-rss.html</guid>
      <description>In which I experiment with hand-writing an rss feed for my own site</description>
    </item>
</rss>

and it seems like it's a common practice to name it "index.xml"

seems like that worked.

Now what?

Some things come to mind:

Create new RSS items for new pages
Update the RSS feed when I update a page?

It seems like changing the guid property is one way to announce an update to a page, since that's probably what a feed-reader is going to use to distinguish items. it seems like it would be a little rude to bounce the guid for an existing page every time I touch it, though.