Skip to content

Add self-hosted changelog with automated version updates#5241

Open
devalog wants to merge 2 commits intomainfrom
devalog/self-hosted-changelog
Open

Add self-hosted changelog with automated version updates#5241
devalog wants to merge 2 commits intomainfrom
devalog/self-hosted-changelog

Conversation

@devalog
Copy link
Copy Markdown
Collaborator

@devalog devalog commented Apr 29, 2026

Summary

  • Adds a self-hosted changelog wired into the docs nav (fern/products/docs/pages/self-hosted/changelog/), with an overview.mdx explaining the upgrade flow and a dated .mdx per release date listing each version's FROM line for fernenterprise/fern-self-hosted.
  • Adds .github/workflows/update-self-hosted-changelog.yml — hourly cron that polls fern-api/fern-platform for new docs@ release tags, appends an entry to the corresponding date file, and opens an auto-merging PR. Idempotent: skips versions already recorded.
  • Backfills the last ~3 weeks of docs@ releases (21 versions, Apr 15 → Apr 28).

Test plan

  • Verify the changelog renders in fern docs dev — overview + 9 dated entries with copy-pasteable FROM code blocks.
  • Confirm the workflow has access to secrets.FERN_GITHUB_TOKEN (needed because fern-api/fern-platform is private).
  • After merge, manually trigger via gh workflow run update-self-hosted-changelog.yml to confirm a no-op run produces no PR (everything backfilled).
  • Wait for the next docs@ release on fern-platform and confirm an auto-PR opens with the new entry.

🤖 Generated with Claude Code

Adds an hourly workflow that polls fern-platform for new docs@ release
tags and opens an auto-merging PR with a dated changelog entry per
version. Backfills the last ~3 weeks of releases.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@@ -0,0 +1,5 @@
### v0.114.1
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[FernStyles.Headings] 'v0.114.1' should use sentence-style capitalization.

@@ -0,0 +1,11 @@
### v0.114.5
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[FernStyles.Headings] 'v0.114.5' should use sentence-style capitalization.

FROM fernenterprise/fern-self-hosted:0.114.5
```

### v0.114.6
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[FernStyles.Headings] 'v0.114.6' should use sentence-style capitalization.

@@ -0,0 +1,17 @@
### v0.114.2
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[FernStyles.Headings] 'v0.114.2' should use sentence-style capitalization.

FROM fernenterprise/fern-self-hosted:0.114.2
```

### v0.114.3
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[FernStyles.Headings] 'v0.114.3' should use sentence-style capitalization.

FROM fernenterprise/fern-self-hosted:0.114.17
```

### v0.114.18
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[FernStyles.Headings] 'v0.114.18' should use sentence-style capitalization.

FROM fernenterprise/fern-self-hosted:0.114.18
```

### v0.114.19
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[FernStyles.Headings] 'v0.114.19' should use sentence-style capitalization.

@@ -0,0 +1,11 @@
### v0.114.20
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[FernStyles.Headings] 'v0.114.20' should use sentence-style capitalization.

FROM fernenterprise/fern-self-hosted:0.114.20
```

### v0.114.21
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[FernStyles.Headings] 'v0.114.21' should use sentence-style capitalization.

</Info>

<Tip>
See [recent releases](/learn/docs/self-hosted/releases) to pin to a specific version instead of `:latest`.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[FernStyles.Current] Avoid time-relative terms like 'latest' that become outdated

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.

1 participant