Refactor RSS markdown output format for clarity and consistency

Author: martrapp

bin/rss-update.ts

@@ -169,9 +169,7 @@ false && fs.writeFileSync(HTML_OUTPUT, html);
 const MARKDOWN_OUTPUT = 'src/content/docs/rss.md';
 
 const markdownItems = items.map(item => `
-- [${item.title}](${item.link}) updated ${rfc822(item.lastModified!)}
-
-${item.description ? `${item.description}` : ''}
+- [${item.title}](${item.link}): ${item.description} (Last updated ${rfc822(item.lastModified!)})
 `).join('');
 
 const markdown = `

src/content/docs/rss.md

@@ -5,127 +5,65 @@ description: Last update dates of all articles on vtbag.dev
 ---
 
 
-- [The View Transition API](https://vtbag.dev/basics/api/) updated Tue, 28 Apr 2026 09:47:58 GMT
+- [The View Transition API](https://vtbag.dev/basics/api/): Basics information about the View Transition browser API (Last updated Tue, 28 Apr 2026 09:47:58 GMT)
 
-Basics information about the View Transition browser API
+- [View Transition Names and Generated Pseudo-Elements](https://vtbag.dev/basics/pseudos/): What are those pseudo-elements of the View Transition API and how can I style and animate them? (Last updated Fri, 24 Apr 2026 19:08:37 GMT)
 
-- [View Transition Names and Generated Pseudo-Elements](https://vtbag.dev/basics/pseudos/) updated Fri, 24 Apr 2026 19:08:37 GMT
+- [Where to Place CSS for Cross-Document View Transitions?](https://vtbag.dev/tips/css/): Your CSS rules are ignored by the View Transition API? Maybe you put them in the wrong place. (Last updated Thu, 23 Apr 2026 11:21:46 GMT)
 
-What are those pseudo-elements of the View Transition API and how can I style and animate them?
+- [View Transitions: What Could Possibly Go Wrong?](https://vtbag.dev/tips/view-transition-fails-and-fixes/): Most of the time, View Transitions just work. This page is for the exceptions: the quirks, the caveats, the things that quietly cancel your animations. Learn how to detect them and bring transitions back to life. (Last updated Mon, 20 Apr 2026 14:06:28 GMT)
 
-- [Where to Place CSS for Cross-Document View Transitions?](https://vtbag.dev/tips/css/) updated Thu, 23 Apr 2026 11:21:46 GMT
+- [API Levels and Implications](https://vtbag.dev/basics/levels/): What are those levels of the View Transition API, and what does that mean for me as a dev? (Last updated Fri, 03 Apr 2026 23:34:47 GMT)
 
-Your CSS rules are ignored by the View Transition API? Maybe you put them in the wrong place.
+- [View Transition JavaScript API](https://vtbag.dev/basics/javascript/): How to interact with view transitions using JavaScript (Last updated Thu, 12 Mar 2026 15:03:26 GMT)
 
-- [View Transitions: What Could Possibly Go Wrong?](https://vtbag.dev/tips/view-transition-fails-and-fixes/) updated Mon, 20 Apr 2026 14:06:28 GMT
+- [Automatically Assigned View Transition Names](https://vtbag.dev/tips/auto-names/): Explore current methods for automatically generating view transition names. (Last updated Thu, 12 Mar 2026 15:03:26 GMT)
 
-Most of the time, View Transitions just work. This page is for the exceptions: the quirks, the caveats, the things that quietly cancel your animations. Learn how to detect them and bring transitions back to life.
+- [Retain Control While Transitioning](https://vtbag.dev/tips/interactivity/): Normally, you cannot interact with a page while view transition animations are running. Here is why that happens, and how to fix it. (Last updated Wed, 04 Mar 2026 14:12:00 GMT)
 
-- [API Levels and Implications](https://vtbag.dev/basics/levels/) updated Fri, 03 Apr 2026 23:34:47 GMT
+- [Add Native View Transitions to Your Starlight Site](https://vtbag.dev/fwvt/twinkling/): Let your Starlight site twinkle in a smooth new light. Learn how to sprinkle some view transition magic on your existing setup. (Last updated Sat, 14 Feb 2026 09:51:09 GMT)
 
-What are those levels of the View Transition API, and what does that mean for me as a dev?
+- [Playing Hide and Seek](https://vtbag.dev/basics/hide-and-seek/): How to control stacking and clipping of view transition images. (Last updated Thu, 05 Feb 2026 14:23:05 GMT)
 
-- [View Transition JavaScript API](https://vtbag.dev/basics/javascript/) updated Thu, 12 Mar 2026 15:03:26 GMT
+- [Ladies and Gentlemen, Start Your Engines!](https://vtbag.dev/fwvt/enabling/): How to enable browser-native cross-document view transitions on your multi-page site. (Last updated Mon, 02 Feb 2026 20:23:16 GMT)
 
-How to interact with view transitions using JavaScript
+- [The Turn-Signal](https://vtbag.dev/tools/turn-signal/): @vtbag/turn-signal simplifies directional view transitions for intuitive history traversal navigation. (Last updated Mon, 02 Feb 2026 20:23:16 GMT)
 
-- [Automatically Assigned View Transition Names](https://vtbag.dev/tips/auto-names/) updated Thu, 12 Mar 2026 15:03:26 GMT
+- [Test Your Browser's View Transition Capabilities](https://vtbag.dev/basics/test-page/): Check what part of the View Transition API is supported by your browser (Last updated Mon, 02 Feb 2026 10:57:11 GMT)
 
-Explore current methods for automatically generating view transition names.
+- [Styling View Transitions](https://vtbag.dev/basics/styling/): Styling view transitions including :active-view-transition-type and view-transition-class (Last updated Wed, 21 Jan 2026 14:21:35 GMT)
 
-- [Retain Control While Transitioning](https://vtbag.dev/tips/interactivity/) updated Wed, 04 Mar 2026 14:12:00 GMT
+- [Flickering during Cross-Fade Animations?](https://vtbag.dev/tips/over-exposure/): Why custom fade animations for view transitions might flash. (Last updated Wed, 21 Jan 2026 14:21:35 GMT)
 
-Normally, you cannot interact with a page while view transition animations are running. Here is why that happens, and how to fix it.
+- [The Utensil Drawer](https://vtbag.dev/tools/utensil-drawer/): A growing collection of lightweight utilities to help you craft polished view transitions. (Last updated Tue, 20 Jan 2026 17:59:04 GMT)
 
-- [Add Native View Transitions to Your Starlight Site](https://vtbag.dev/fwvt/twinkling/) updated Sat, 14 Feb 2026 09:51:09 GMT
+- [The Cam-Shaft](https://vtbag.dev/tools/cam-shaft/): Bump your view transition images into position to avoid that unexpected pseudo-smooth-scrolling. (Last updated Tue, 06 Jan 2026 15:32:00 GMT)
 
-Let your Starlight site twinkle in a smooth new light. Learn how to sprinkle some view transition magic on your existing setup.
+- [The Element Crossing](https://vtbag.dev/tools/element-crossing/): @vtbag/element-crossing allows you carry over state to the next page when using cross-document view transitions (Last updated Tue, 06 Jan 2026 15:32:00 GMT)
 
-- [Playing Hide and Seek](https://vtbag.dev/basics/hide-and-seek/) updated Thu, 05 Feb 2026 14:23:05 GMT
+- [The Inspection Chamber](https://vtbag.dev/tools/inspection-chamber/): @vtbag/inspection-chamber allows you to examine, judge & optimize all aspects of your view transitions (Last updated Tue, 06 Jan 2026 15:32:00 GMT)
 
-How to control stacking and clipping of view transition images.
+- [@vtbag: Overview](https://vtbag.dev/vtbag/): What are those Bags of Tricks? (Last updated Sun, 04 Jan 2026 22:42:00 GMT)
 
-- [Ladies and Gentlemen, Start Your Engines!](https://vtbag.dev/fwvt/enabling/) updated Mon, 02 Feb 2026 20:23:16 GMT
+- [Playing Tower of Hanoi](https://vtbag.dev/fwvt/playing/): Fun With View Transitions, Episode 7: Tips, tricks, and fresh ideas to spark your own view transition magic! (Last updated Sat, 08 Nov 2025 07:35:44 GMT)
 
-How to enable browser-native cross-document view transitions on your multi-page site.
+- [Why View Transitions Might Break on Mobile](https://vtbag.dev/fwvt/uncovering/): Figure out why view transitions might fail on mobile for no clear reason. (Last updated Sat, 08 Nov 2025 07:35:44 GMT)
 
-- [The Turn-Signal](https://vtbag.dev/tools/turn-signal/) updated Mon, 02 Feb 2026 20:23:16 GMT
+- [Check and Control the Image Animations!](https://vtbag.dev/fwvt/customizing/): How to override the defaults animations for the ::view-transition-old and ::view-transition-new pseudo-elements. (Last updated Sun, 19 Oct 2025 22:56:45 GMT)
 
-@vtbag/turn-signal simplifies directional view transitions for intuitive history traversal navigation.
+- [On a Trip to the Text Morphology Clinic](https://vtbag.dev/fwvt/healing/): Join Dr. Bag on patient rounds as we explore text-morph animations crafted with the View Transition API. Discover common issues, explore diagnostic techniques, and apply effective treatments. (Last updated Sun, 19 Oct 2025 22:56:45 GMT)
 
-- [Test Your Browser's View Transition Capabilities](https://vtbag.dev/basics/test-page/) updated Mon, 02 Feb 2026 10:57:11 GMT
+- [Hello, and welcome to Fun with View Transitions!](https://vtbag.dev/fwvt/welcome/): Embark on a journey into the marvelous land of the View Transition API. (Last updated Tue, 14 Oct 2025 21:23:20 GMT)
 
-Check what part of the View Transition API is supported by your browser
+- [Default View Transition Animations](https://vtbag.dev/basics/default-animations/): Mastering the fundamentals is key to creating seamless animations with the View Transition API. Here's a quick guide to get you started. (Last updated Sat, 02 Aug 2025 18:42:31 GMT)
 
-- [Styling View Transitions](https://vtbag.dev/basics/styling/) updated Wed, 21 Jan 2026 14:21:35 GMT
+- [Make Your Images Glide Across the Screen](https://vtbag.dev/fwvt/morphing/): Let's add the morph animations that have made the View Transition API so renowned. (Last updated Wed, 30 Jul 2025 16:49:39 GMT)
 
-Styling view transitions including :active-view-transition-type and view-transition-class
+- [Support in Web Frameworks](https://vtbag.dev/basics/frameworks/): What is special when using React's <ViewTransition /> (Last updated Thu, 10 Jul 2025 16:23:33 GMT)
 
-- [Flickering during Cross-Fade Animations?](https://vtbag.dev/tips/over-exposure/) updated Wed, 21 Jan 2026 14:21:35 GMT
+- [Pseudo-Smooth-Scrolling](https://vtbag.dev/tips/pseudo-smooth-scrolling/): Instant scrolling on a page with view transition might lead to an unexpected smooth-scrolling effect.  (Last updated Thu, 06 Feb 2025 13:57:11 GMT)
 
-Why custom fade animations for view transitions might flash.
+- [View Transition Examples](https://vtbag.dev/basics/examples/): Basic examples on how to use the View Transition API for same-document and cross-document view transitions. (Last updated Thu, 05 Dec 2024 16:09:57 GMT)
 
-- [The Utensil Drawer](https://vtbag.dev/tools/utensil-drawer/) updated Tue, 20 Jan 2026 17:59:04 GMT
-
-A growing collection of lightweight utilities to help you craft polished view transitions.
-
-- [The Cam-Shaft](https://vtbag.dev/tools/cam-shaft/) updated Tue, 06 Jan 2026 15:32:00 GMT
-
-Bump your view transition images into position to avoid that unexpected pseudo-smooth-scrolling.
-
-- [The Element Crossing](https://vtbag.dev/tools/element-crossing/) updated Tue, 06 Jan 2026 15:32:00 GMT
-
-@vtbag/element-crossing allows you carry over state to the next page when using cross-document view transitions
-
-- [The Inspection Chamber](https://vtbag.dev/tools/inspection-chamber/) updated Tue, 06 Jan 2026 15:32:00 GMT
-
-@vtbag/inspection-chamber allows you to examine, judge & optimize all aspects of your view transitions
-
-- [@vtbag: Overview](https://vtbag.dev/vtbag/) updated Sun, 04 Jan 2026 22:42:00 GMT
-
-What are those Bags of Tricks?
-
-- [Playing Tower of Hanoi](https://vtbag.dev/fwvt/playing/) updated Sat, 08 Nov 2025 07:35:44 GMT
-
-Fun With View Transitions, Episode 7: Tips, tricks, and fresh ideas to spark your own view transition magic!
-
-- [Why View Transitions Might Break on Mobile](https://vtbag.dev/fwvt/uncovering/) updated Sat, 08 Nov 2025 07:35:44 GMT
-
-Figure out why view transitions might fail on mobile for no clear reason.
-
-- [Check and Control the Image Animations!](https://vtbag.dev/fwvt/customizing/) updated Sun, 19 Oct 2025 22:56:45 GMT
-
-How to override the defaults animations for the ::view-transition-old and ::view-transition-new pseudo-elements.
-
-- [On a Trip to the Text Morphology Clinic](https://vtbag.dev/fwvt/healing/) updated Sun, 19 Oct 2025 22:56:45 GMT
-
-Join Dr. Bag on patient rounds as we explore text-morph animations crafted with the View Transition API. Discover common issues, explore diagnostic techniques, and apply effective treatments.
-
-- [Hello, and welcome to Fun with View Transitions!](https://vtbag.dev/fwvt/welcome/) updated Tue, 14 Oct 2025 21:23:20 GMT
-
-Embark on a journey into the marvelous land of the View Transition API.
-
-- [Default View Transition Animations](https://vtbag.dev/basics/default-animations/) updated Sat, 02 Aug 2025 18:42:31 GMT
-
-Mastering the fundamentals is key to creating seamless animations with the View Transition API. Here's a quick guide to get you started.
-
-- [Make Your Images Glide Across the Screen](https://vtbag.dev/fwvt/morphing/) updated Wed, 30 Jul 2025 16:49:39 GMT
-
-Let's add the morph animations that have made the View Transition API so renowned.
-
-- [Support in Web Frameworks](https://vtbag.dev/basics/frameworks/) updated Thu, 10 Jul 2025 16:23:33 GMT
-
-What is special when using React's <ViewTransition />
-
-- [Pseudo-Smooth-Scrolling](https://vtbag.dev/tips/pseudo-smooth-scrolling/) updated Thu, 06 Feb 2025 13:57:11 GMT
-
-Instant scrolling on a page with view transition might lead to an unexpected smooth-scrolling effect. 
-
-- [View Transition Examples](https://vtbag.dev/basics/examples/) updated Thu, 05 Dec 2024 16:09:57 GMT
-
-Basic examples on how to use the View Transition API for same-document and cross-document view transitions.
-
-- [Pointer Flickering](https://vtbag.dev/tips/pointer/) updated Wed, 20 Nov 2024 16:33:50 GMT
-
-Your cursor can be a tricky shape-shifter during view transitions. Here's how to keep it in line.
+- [Pointer Flickering](https://vtbag.dev/tips/pointer/): Your cursor can be a tricky shape-shifter during view transitions. Here's how to keep it in line. (Last updated Wed, 20 Nov 2024 16:33:50 GMT)