Skip to content

Conversation

@bluestreak01
Copy link
Member

@bluestreak01 bluestreak01 commented Jan 29, 2026

Summary

  • Adds automatic RSS feed generation at /docs/rss.xml based on git commit history
  • Adds a changelog page at /docs/changelog/ displaying the 20 most recently updated documentation pages
  • Adds RSS autodiscovery <link> tag in HTML head for RSS reader auto-detection
  • Supports changelog: false frontmatter to exclude specific pages from the feed
  • Respects custom slug frontmatter when generating URLs

Implementation

New plugin: plugins/docs-rss/index.js

  • Scans all documentation files during build
  • Extracts last modified dates from git history
  • Generates RSS 2.0 feed with title, link, date, and description excerpt
  • Exposes changelog data via Docusaurus global data for the changelog page

New component: src/components/Changelog/index.tsx

  • Displays recently updated pages grouped by date
  • Includes RSS subscribe button with icon

New page: documentation/changelog.mdx

  • Documentation changelog page using the Changelog component

Test plan

  • Run yarn build and verify no errors
  • Check /docs/rss.xml is generated with valid RSS content
  • Verify /docs/changelog/ page renders correctly
  • Test RSS feed in an RSS reader
  • Verify pages with changelog: false are excluded

🤖 Generated with Claude Code

Add automatic RSS feed generation and a changelog page that displays
recently updated documentation pages based on git commit history.

- Add docs-rss plugin that generates RSS feed from git history
- Add /docs/changelog page showing 20 most recently updated pages
- Add RSS autodiscovery link in HTML head
- Support `changelog: false` frontmatter to exclude pages
- Respect custom slug frontmatter for URL generation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@github-actions
Copy link

github-actions bot commented Jan 29, 2026

🤖 Component Converter Reminder

A component in src/components/ or src/theme/ was modified in this pull request.

We are creating markdown correspondents of every path (e.g. questdb.com/docs/quick-start → questdb.com/docs/quick-start/index.md) for LLM consumption.
If the component usage is shadowing useful content, it may need a converter for markdown output in convert-components.js.

Quick Check

  • Content component (code, tables, data) → Add converter if not exists
  • UI/visual component (styling, buttons, decorative) → No converter needed

💡 This is a friendly reminder, not a blocker. Ignore if not applicable.

@github-actions
Copy link

github-actions bot commented Jan 29, 2026

🚀 Build success!

Latest successful preview: https://preview-353--questdb-documentation.netlify.app/docs/

Commit SHA: 76ef68a

📦 Build generates a preview & updates link on each commit.

bluestreak01 and others added 6 commits January 29, 2026 20:05
The docs-rss plugin uses git log to determine file modification dates.
Netlify's shallow clones caused all files to show the same date.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Detects shallow clone (e.g., Netlify) and fetches file modification
dates from GitHub API instead of git log. Falls back to local git
when full history is available.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Set GIT_CLONE_DEPTH=0 in netlify.toml for full history.
Reverted plugin to simple git-only version.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
GIT_CLONE_DEPTH not respected by Netlify. Falls back to GitHub API
when shallow clone detected.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@bluestreak01 bluestreak01 deleted the vi_rss branch January 29, 2026 20:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants