Add Changed subtitle to new entries

Author: Genevieve Nuebel

.github/changelog_manager.rb

@@ -109,7 +109,9 @@ def build_entry(api_version, version_number, date)
 
       <<~ENTRY
         ## [#{version_number}] - #{date_str} (#{api_version} API)
-        #{message}
+        
+        ### Changed
+        - #{message}
       ENTRY
     end
 

.github/spec/changelog_manager_spec.rb

@@ -59,6 +59,7 @@ def read_changelog
 
       updated_content = read_changelog
       expect(updated_content).to include('## [3.0.0] - 2026-01-28 (v20250224 API)')
+      expect(updated_content).to include('### Changed')
       expect(updated_content).to include('Updated v20250224 API specification to most current version')
       expect(updated_content).to include('[API changelog]')
 
@@ -86,6 +87,7 @@ def read_changelog
       expect(updated_content).to include('## [2.0.0] - 2026-01-28 (v20111101 API)')
       expect(updated_content).to include('Updated v20250224 API specification to most current version')
       expect(updated_content).to include('Updated v20111101 API specification to most current version')
+      expect(updated_content).to include('### Changed')
 
       # v20250224 should come BEFORE v20111101 (sorting)
       v20250224_pos = updated_content.index('[3.0.0]')
@@ -103,6 +105,7 @@ def read_changelog
       expect(result).to be true
       updated_content = read_changelog
       expect(updated_content).to include('## [3.0.0] - 2026-01-28 (v20250224 API)')
+      expect(updated_content).to include('### Changed')
     end
   end
 
@@ -123,6 +126,21 @@ def read_changelog
       v20111101_pos = updated_content.index('[2.0.0]')
       expect(v20250224_pos).to be < v20111101_pos
     end
+
+    it 'includes changed section for each entry' do
+      setup_changelog
+      setup_version_directory('v20250224', v20250224_package_fixture)
+      setup_version_directory('v20111101', v20111101_package_fixture)
+
+      result = ChangelogManager.update('v20250224,v20111101')
+
+      expect(result).to be true
+      updated_content = read_changelog
+
+      # Count occurrences of ### Changed - should be 2 for the new entries
+      changed_count = updated_content.scan(/### Changed/).length
+      expect(changed_count).to be >= 2 # At least 2 from the new entries
+    end
   end
 
   describe '.update with date range behavior' do
@@ -150,6 +168,8 @@ def read_changelog
       expect(updated_content).to include('Updated v20250224 API specification to most current version. Please check full [API changelog]')
       # Should NOT have a "between" clause
       expect(updated_content).not_to match(/between \d{4}-\d{2}-\d{2} and \d{4}-\d{2}-\d{2}.*v20250224/)
+      # Should include Changed section
+      expect(updated_content).to include('### Changed')
     end
 
     it 'uses correct dates in range for multiple version updates' do
@@ -168,6 +188,8 @@ def read_changelog
       # v20250224 should NOT have date range (no prior entry)
       v20250224_section = updated_content[/## \[3\.0\.0\].*?(?=##|\z)/m]
       expect(v20250224_section).not_to match(/between.*v20250224/)
+      # Both should have Changed section
+      expect(updated_content).to include('### Changed')
     end
   end
 
@@ -239,6 +261,7 @@ def read_changelog
       # Verify changelog was updated
       updated_content = read_changelog
       expect(updated_content).to include('## [3.0.0] - 2026-01-28 (v20250224 API)')
+      expect(updated_content).to include('### Changed')
     end
 
     it 'exits with error when versions argument is nil' do

CHANGELOG.md

@@ -5,7 +5,7 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [2.0.0] - 2026-01-07
+## [2.0.0] - 2026-01-07 (v20111101 API)
 
 ### Changed
 - **Versioning Correction:** Re-released as v2.0.0 to properly indicate breaking changes that were inadvertently introduced in v1.10.1
@@ -23,7 +23,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 - Restructured API classes from single `MxPlatformApi` to domain-specific classes
 
-## [1.12.1] - 2025-11-25
+## [1.12.1] - 2025-11-25 (v20111101 API)
 
 ### Fixed
 - Updated package template (`package.mustache`) to fix recurring dependency regression
@@ -42,7 +42,7 @@ These versions (v1.10.1 through v1.12.0) contain the breaking API restructure bu
 
 **If you are on any of these versions:** Please upgrade to v2.0.0.
 
-## [1.10.0] - 2025-11-05
+## [1.10.0] - 2025-11-05 (v20111101 API)
 
 ### Note
 - Last stable version with unified `MxPlatformApi` class

docs/Changelog-Manager.md

@@ -55,24 +55,32 @@ The entries are inserted in version order (v20250224 first, v20111101 second), e
 Result:
 ```markdown
 ## [3.2.0] - 2025-01-28 (v20250224 API)
-Updated v20250224 API specification to most current version...
+
+### Changed
+- Updated v20250224 API specification to most current version...
 
 ## [2.5.3] - 2025-01-28 (v20111101 API)
-Updated v20111101 API specification to most current version...
+
+### Changed
+- Updated v20111101 API specification to most current version...
 ```
 
 ### Example Output
 
 With a prior entry:
 ```markdown
 ## [3.2.0] - 2025-01-28 (v20250224 API)
-Updated v20250224 API specification to most current version. Please check full [API changelog](https://docs.mx.com/resources/changelog/platform) for any changes made between 2025-01-15 and 2025-01-28.
+
+### Changed
+- Updated v20250224 API specification to most current version. Please check full [API changelog](https://docs.mx.com/resources/changelog/platform) for any changes made between 2025-01-15 and 2025-01-28.
 ```
 
 Without a prior entry:
 ```markdown
 ## [3.2.0] - 2025-01-28 (v20250224 API)
-Updated v20250224 API specification to most current version. Please check full [API changelog](https://docs.mx.com/resources/changelog/platform) for any changes.
+
+### Changed
+- Updated v20250224 API specification to most current version. Please check full [API changelog](https://docs.mx.com/resources/changelog/platform) for any changes.
 ```
 
 ## Location

docs/Workflow-and-Configuration-Reference.md

@@ -106,10 +106,12 @@ strategy:
      # Changelog
      
      ## [3.0.1] - 2026-01-27 (v20250224 API)
-     Updated v20250224 API specification...
+     ### Changed
+     - Updated v20250224 API specification...
      
      ## [2.0.1] - 2026-01-27 (v20111101 API)
-     Updated v20111101 API specification...
+     ### Changed
+     - Updated v20111101 API specification...
      ```
 
 4. **Copy Documentation to Version Directories**