RSS changelogs v2 (#930)

* remove `rss` object from Update page

* update changelog info

* update example RSS feed

Author: ethanpalm

components/update.mdx

@@ -29,8 +29,7 @@ Use the `Update` component to display changelog entries, version updates, and re
 
 ```mdx Update example
 <Update label="2024-10-11" description="v0.1.0" tags={["Mintlify"]}>
-  This is how you use a changelog with a label, description,
-  and tags.
+  This is an update with a label, description, and tag.
 </Update>
 ```
 
@@ -49,28 +48,3 @@ Use multiple `Update` components to create [changelogs](/guides/changelogs).
 <ResponseField name="description" type="string">
   Description of the update. Appears below the label and tag.
 </ResponseField>
-
-<ResponseField name="rss" type="object">
-  Title and description that will appear in the RSS feed entry for the update.
-  
-  ```mdx wrap
-  <Update label="v1.0.1" rss={{ title: "v1.0.1 released", description: "Bug fixes and improvements" }}>
-    # What's New in v1.0.1
-    
-    * Bug fixes
-    * Improvements
-  </Update>
-  ```
-
-```xml Example Update item in RSS feed
-  <item>
-    <title><![CDATA[v1.0.1 released]]></title>
-    <description><![CDATA[Bug fixes and improvements]]></description>
-    <link>https://mintlify.com/changelog#v101</link>
-    <guid isPermaLink="true">https://mintlify.com/changelog#v101</guid>
-    <pubDate>Fri, 20 Jun 2025 21:32:19 GMT</pubDate>
-  </item>
-```
-
-  Learn more about [subscribable changelogs](/guides/changelogs#subscribable-changelogs).
-</ResponseField>

guides/changelogs.mdx

@@ -100,27 +100,31 @@ Add `tags` to your `Update` components to replace the table of contents with tag
 
 ### Subscribable changelogs
 
-Using `Update` components creates a subscribable RSS feed at your page URL + `/rss.xml`. For example, `mintlify.com/docs/changelog/rss.xml`. New updates are automatically included in the feed when published.
+Using `Update` components creates a subscribable RSS feed at your page URL with `/rss.xml` appended. For example, `mintlify.com/docs/changelog/rss.xml`.
+
+Entries are added to the RSS feed when new `Update` components are published and when new headings are added inside of existing `<Update>` tags.
+
+The top level headings of `Update` components are used as the titles of RSS feed entries, and the entries link to their heading anchors in your docs.
 
 ```xml Example RSS feed
-<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0">
-    <channel>
-        <title><![CDATA[Product Updates]]></title>
-        <description><![CDATA[New updates and improvements]]></description>
-        <link>https://mintlify-changelogs-guide.mintlify.app</link>
-        <generator>RSS for Node</generator>
-        <lastBuildDate>Fri, 20 Jun 2025 21:36:14 GMT</lastBuildDate>
-        <atom:link href="https://mintlify-changelogs-guide.mintlify.app/changelog/rss.xml" rel="self" type="application/rss+xml"/>
-        <copyright><![CDATA[Mintlify]]></copyright>
-        <docs>https://mintlify-changelogs-guide.mintlify.app</docs>
-        <item>
-            <title><![CDATA[Subscribable changelogs]]></title>
-            <description><![CDATA[Post product updates in your docs with a subscribable RSS feed]]></description>
-            <link>https://mintlify-changelogs-guide.mintlify.app/changelog#june-20-2025</link>
-            <guid isPermaLink="true">https://mintlify-changelogs-guide.mintlify.app/changelog#june-20-2025</guid>
-            <pubDate>Fri, 20 Jun 2025 21:04:47 GMT</pubDate>
-        </item>
-    </channel>
+<?xml version="1.0" encoding="UTF-8"?>
+<rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0">
+  <channel>
+    <title><![CDATA[Product updates]]></title>
+    <description><![CDATA[New updates and improvements]]></description>
+    <link>https://mintlify.com/docs</link>
+    <generator>RSS for Node</generator>
+    <lastBuildDate>Mon, 21 Jul 2025 21:21:47 GMT</lastBuildDate>
+    <atom:link href="https://mintlify.com/docs/changelog/rss.xml" rel="self" type="application/rss+xml"/>
+    <copyright><![CDATA[Mintlify]]></copyright>
+    <docs>https://mintlify.com/docs</docs>
+    <item>
+      <title><![CDATA[June 2025]]></title>
+      <link>https://mintlify.com/docs/changelog#june-2025</link>
+      <guid isPermaLink="true">https://mintlify.com/docs/changelog#june-2025</guid>
+      <pubDate>Mon, 23 Jun 2025 16:54:22 GMT</pubDate>
+    </item>
+  </channel>
 </rss>
 ```