Skip to content

Add managed product updates and public changelog - #195

Merged
s3rot0n1n merged 3 commits into
mainfrom
t3/research-changelog-management
Nov 7, 2026
Merged

s3rot0n1n merged 3 commits into
mainfrom
t3/research-changelog-management

Conversation

@s3rot0n1n

Copy link
Copy Markdown
Contributor

Summary

  • Add a managed product updates workflow with validated labels and release dates, plus a public changelog with entry anchors, RSS, structured data, and AI indexing.
  • Remove the changelog GitHub import and related MCP tools; normalize existing changelog metadata with migration 0015.
  • Update the product update editor and changelog management documentation.

Testing

  • Format check and typecheck passed.
  • API tests passed (794); sites tests passed (86); dashboard tests passed (97).
  • E2E browser smoke passed for draft and publish flows, changelog page and anchors, RSS, Markdown, AI indexing, and docs GitHub settings.
  • Chatbot citation response and completing GitHub OAuth were not run: no AI provider key was configured, and GitHub sign-in required an interactive login.

- Replace GitHub changelog imports with managed product updates, RSS, and MCP support
- Normalize existing changelog metadata and document the new workflow
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 7, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-07T09:49:31.300804Z 43d397a PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 43d397aa0b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

</li>
))}
{/* The entry title is its permalink (`/changelog#<slug>`). */}
<a href={`#${entry.slug}`} className="group mt-2 block">

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Render the permalink with the public-site link primitives

The new raw <a> makes the changelog title a navigation control without the required themed link treatment. Keep the #slug behavior, but render it through the site's link wrapper and themed PageBuilder link primitive so custom link styles apply.

AGENTS.md reference: AGENTS.md:L20-L28

Useful? React with 👍 / 👎.

});
const baseProductUpdatesContract = makeDocumentContract(
/** Product updates are documents internally (`kind: "changelog"`). */
const productUpdatesContract = makeDocumentContract(

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Remove the importer from the OpenAPI description

After this contract removes the GitHub product-update endpoints, generated API docs still describe the Changelog tag as supporting “GitHub release import” (apps/api/src/openapi.ts:73). Update that description alongside this removal so API users are not told the deleted feature is available.

Useful? React with 👍 / 👎.

Rajat and others added 2 commits November 7, 2026 16:56
A changelog entry is now a title, body and optional release date.

- Remove `version`: it duplicated the title and could disagree with it.
  Versioned products put the version in the title ("v1.2.0: Dark mode").
- Remove change-type `labels`: entry badges repeated the body's
  `### Added` / `### Fixed` sections and were never filtered on.
- Migration 0015 drops `meta.version` and `meta.labels` (pre-production,
  rewritten in place).
- Document the page's scale limits: no pagination, 1,000-entry cutoff.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Link each entry's permalink through the site link wrapper (`SiteLink`)
  instead of a raw anchor, matching the article feed.
- Drop "GitHub release import" from the Changelog OpenAPI tag description.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@s3rot0n1n
s3rot0n1n merged commit a3d7931 into main Nov 7, 2026
3 checks passed
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