Skip to content

Consider merging Pro changelog into main CHANGELOG.md #2192

@justin808

Description

@justin808

Summary

Currently we maintain two separate changelogs:

  • /CHANGELOG.md - Open source React on Rails
  • /react_on_rails_pro/CHANGELOG.md - Pro features

Proposal

Merge Pro entries into the main CHANGELOG.md with a #### Pro subcategory under each release version.

Benefits

  1. Fix diff links - Currently diff links between versions don't work correctly across separate files
  2. Marketing benefit - Users see Pro features in the same changelog and may want to upgrade
  3. Simpler maintenance - One file to update instead of two
  4. Better discoverability - Pro users see all changes in one place

Implementation

  • Add #### Pro subcategory under each release version in CHANGELOG.md
  • Move relevant Pro entries from react_on_rails_pro/CHANGELOG.md
  • Potentially deprecate the separate Pro changelog
  • Update documentation about changelog conventions in CLAUDE.md

Context

This came up during changelog curation for v16.2.0.beta.13 release, where Pro-only PRs (#2139, #2137) needed to be tracked separately, and the diff links between versions were problematic.


Filed from branch jg/changelog-beta13

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions