chore(release): update CHANGELOG to follow Keep a Changelog format

Author: HeyItsGilbert

CHANGELOG.md

@@ -5,236 +5,157 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
-## [2.0.0] - 2025-06-18
+## [2.0.0] 2025-06-18
 
-### Major Release - Plaster 2.0
+### Added
 
-This is a major release that modernizes Plaster for PowerShell 7.x while
-maintaining full backward compatibility with existing templates and workflows.
+- Cross-platform compatibility with full support for Windows, Linux, and macOS
+- PowerShell 7.x optimization with improved performance and reliability
+- Enhanced error handling with comprehensive error handling and detailed logging
+- Modern PowerShell parameter validation attributes and type safety
+- Built-in logging system with configurable levels
+- Modern InvokeBuild-based build system replacing legacy psake
+- Pester 5.x support with updated test framework syntax
+- Cross-platform CI/CD with GitHub Actions workflow supporting all platforms
+- Integrated code coverage reporting with configurable thresholds
+- Enhanced PSScriptAnalyzer integration with modern rules
+- Parameter element now supports a condition attribute for conditional prompting
+- Better error messages with actionable guidance
+- Improved debug output and verbose logging
+- Better IntelliSense support with improved parameter completion and help text
+- Automatic path separator handling across platforms
+- Consistent UTF-8 encoding with BOM handling across platforms
+- Platform-specific defaults based on operating system
+- Proper handling of different line ending styles
+- Comprehensive test suite covering all platforms with integration and
+  performance tests
+- Automated testing on Windows, Linux, and macOS
 
-### BREAKING CHANGES
+### Changed
 
-- **Minimum PowerShell Version**: Updated from 3.0 to 5.1
-- **Test Framework**: Updated to Pester 5.x (breaking change for test authors)
-- **Default Encoding**: Changed from 'Default' to 'UTF8-NoBOM' for better
+- Minimum PowerShell version updated from 3.0 to 5.1
+- Default encoding changed from 'Default' to 'UTF-8-NoBOM' for better
   cross-platform compatibility
+- Test framework updated to Pester 5.x (breaking change for test authors)
+- Module structure reorganized for better maintainability
+- Error handling centralized with improved logging
+- Platform-specific functionality abstracted for better cross-platform support
+- Optimized module loading and reduced startup time
+- Improved memory usage and garbage collection
+- Enhanced template processing performance on large projects
+- Improved file operations for different platforms
+- Better parameter completion and help text
 
-### NEW FEATURES
-
-#### PowerShell 7.x Full Support
-
-- **Cross-Platform Compatibility**: Full support for Windows, Linux, and macOS
-- **PowerShell Core Optimization**: Improved performance and reliability on
-  PowerShell 7.x
-- **Platform Detection**: Enhanced platform-specific functionality and path
-  handling
-
-#### Modern Development Practices
-
-- **Enhanced Error Handling**: Comprehensive error handling with detailed
-  logging
-- **Parameter Validation**: Modern PowerShell parameter validation attributes
-- **Type Safety**: Improved type safety using PowerShell classes and `using`
-  statements
-- **Logging System**: Built-in logging system with configurable levels
-
-#### Build and Development
-
-- **Modern Build System**: InvokeBuild-based build system replacing legacy psake
-- **Pester 5.x Support**: Updated test framework with modern Pester 5.x syntax
-- **Cross-Platform CI/CD**: GitHub Actions workflow supporting all platforms
-- **Code Coverage**: Integrated code coverage reporting with configurable
-  thresholds
-- **Static Analysis**: Enhanced PSScriptAnalyzer integration with modern rules
-
-### IMPROVEMENTS
-
-#### Performance
-
-- **Faster Module Loading**: Optimized module loading and reduced startup time
-- **Memory Usage**: Improved memory usage and garbage collection
-- **Template Processing**: Enhanced template processing performance on large
-  projects
-- **Cross-Platform I/O**: Optimized file operations for different platforms
-
-#### Developer Experience
-
-- **Better Error Messages**: More descriptive error messages with actionable
-  guidance
-- **Enhanced Debugging**: Improved debug output and verbose logging
-- **IntelliSense Support**: Better parameter completion and help text
-- **Modern PowerShell Features**: Leverages PowerShell 5.1+ and 7.x features
-
-#### Cross-Platform Enhancements
-
-- **Path Normalization**: Automatic path separator handling across platforms
-- **Encoding Handling**: Consistent UTF-8 encoding with BOM handling
-- **Platform-Specific Defaults**: Smart defaults based on operating system
-- **Line Ending Normalization**: Proper handling of different line ending styles
-
-### BUG FIXES
-
-#### Core Issues
+### Fixed
 
-- **XML Schema Validation**: Fixed .NET Core XML schema validation issues
+- XML schema validation issues on .NET Core
   ([#107](https://github.com/PowerShellOrg/Plaster/issues/107))
-- **Constrained Runspace**: Resolved PowerShell 7.x constrained runspace
-  compatibility
-- **Path Resolution**: Fixed absolute vs relative path handling across platforms
-- **Parameter Store**: Corrected parameter default value storage on non-Windows
-  platforms
-
-#### Template Processing
-
-- **Variable Substitution**: Fixed edge cases in parameter substitution
-- **Conditional Logic**: Improved reliability of condition evaluation
-- **File Encoding**: Resolved encoding issues with template files
-- **Directory Creation**: Fixed recursive directory creation on Unix systems
-
-#### Module Loading
-
-- **Import Errors**: Resolved module import issues on PowerShell Core
-- **Dependency Resolution**: Fixed module dependency loading order
-- **Resource Loading**: Improved localized resource loading reliability
-
-### MIGRATION GUIDE
-
-#### For Template Authors
-
-1. **No Changes Required**: Existing XML templates work without modification
-2. **Encoding**: Consider updating templates to use UTF-8 encoding
-3. **Testing**: Update any custom tests to use Pester 5.x syntax
-
-#### For Template Users
-
-1. **PowerShell Version**: Ensure PowerShell 5.1 or higher is installed
-2. **Module Update**: Use `Update-Module Plaster` to get version 2.0
-3. **Workflows**: No changes required to existing Invoke-Plaster usage
-
-#### For Contributors
-
-1. **Build System**: Use `./build.ps1` instead of psake commands
-2. **Tests**: Update to Pester 5.x syntax and configuration
-3. **Development**: Follow new coding standards and use modern PowerShell
-   features
-
-### INTERNAL CHANGES
-
-#### Code Quality
-
-- **PSScriptAnalyzer**: Updated to latest rules and best practices
-- **Code Coverage**: Achieved >80% code coverage across all modules
-- **Documentation**: Comprehensive inline documentation and examples
-- **Type Safety**: Added parameter validation and type constraints
+- PowerShell 7.x constrained runspace compatibility issues
+- Absolute vs relative path handling across platforms
+- Parameter default value storage on non-Windows platforms
+- Edge cases in parameter substitution
+- Condition evaluation reliability
+- Template file encoding issues
+- Recursive directory creation on Unix systems
+- Module import issues on PowerShell Core
+- Module dependency loading order
+- Localized resource loading reliability
+
+## [1.1.4] Unreleased
 
-#### Architecture
+### Added
 
-- **Module Structure**: Reorganized for better maintainability
-- **Error Handling**: Centralized error handling and logging
-- **Resource Management**: Improved resource cleanup and disposal
-- **Platform Abstraction**: Abstracted platform-specific functionality
+- None
 
-#### Testing
+### Changed
 
-- **Test Coverage**: Comprehensive test suite covering all platforms
-- **Integration Tests**: Added end-to-end integration testing
-- **Performance Tests**: Benchmarking for performance regression detection
-- **Cross-Platform Tests**: Automated testing on Windows, Linux, and macOS
+- Updated PSScriptAnalyzerSettings.psd1 template file to sync with latest in
+  vscode-powershell examples
+- Text parameter with default value where condition evaluates to false now
+  returns default value
 
-### ACKNOWLEDGMENTS
+### Fixed
 
-Special thanks to the PowerShell community for their patience during the
-transition and to all contributors who helped modernize Plaster for the
-PowerShell 7.x era.
+- Write destination path with Write-Host so it doesn't add extra output when
+  -PassThru specified [#326](https://github.com/PowerShell/Plaster/issues/326)
 
-### COMPATIBILITY MATRIX
+## [1.1.1] 2017-10-26
 
-| PowerShell Version | Windows | Linux | macOS | Status              |
-|--------------------|---------|-------|-------|---------------------|
-| 5.1 (Desktop)      | ✅      | ❌    | ❌   | Fully Supported     |
-| 7.0+ (Core)        | ✅      | ✅    | ✅   | Fully Supported     |
-| 3.0-5.0            | ❌      | ❌    | ❌   | No Longer Supported |
+### Fixed
 
----
+- Added $IsMacOS variable to constrained runspace
+  [#291](https://github.com/PowerShell/Plaster/issues/291)
+- Added missing .cat file from 1.1.0 release
+  [#292](https://github.com/PowerShell/Plaster/issues/292)
 
-## 1.1.4 - (Unreleased - Legacy)
+## [1.1.0] 2017-10-25
 
-### Fixed
+### Added
 
-- Write destination path with Write-Host so it doesn't add extra output when
-  -PassThru specified [#326](https://github.com/PowerShell/Plaster/issues/326).
+- Constrained runspace cmdlet: Out-String
+  [#235](https://github.com/PowerShell/Plaster/issues/236)
+- Constrained runspace variables: PSVersionTable and on >= PS v6 IsLinux,
+  IsOSX and IsWindows [#239](https://github.com/PowerShell/Plaster/issues/239)
+- Parameter element now supports a condition attribute so that prompting for
+  parameters can be conditional based on environmental factors (such as OS) or
+  answers to previous parameter prompts. This allows template authors to build a
+  "dynamic" set of prompts
+- Constrained runspace cmdlet: Compare-Object
+  [#286](https://github.com/PowerShell/Plaster/issues/287)
 
 ### Changed
 
-- Updated PSScriptAnalyzerSettings.psd1 template file to sync w/latest in
-  vscode-powershell examples.
-- Text parameter with default value where condition evaluates to false returns
-  default value.
-
-## 1.1.1 - 2017-10-26
+- Simplified New Module Script template user choices (removed prompt for adding
+  Pester test; the test is now always added)
 
 ### Fixed
 
-- Added $IsMacOS variable to constrained runspace
-  [#291](https://github.com/PowerShell/Plaster/issues/291).
-- Added missing .cat file from 1.1.0 release
-  [#292](https://github.com/PowerShell/Plaster/issues/292).
+- Fixed prompt errors when prompt text is null or empty
+  [#236](https://github.com/PowerShell/Plaster/issues/236)
+- Fixed New Module Script template's Test task which fails to run on x64 Visual
+  Studio Code
+- Fixed Test-PlasterManifest on non-Windows running .NET Core 2.0 which failed
+  with path using \ instead of /. Thanks to
+  [@elmundio87](https://github.com/elmundio87) via PR
+  [#282](https://github.com/PowerShell/Plaster/pull/282)
 
-## 1.1.0 - 2017-10-25
+## [1.0.1] 2016-12-16
 
 ### Fixed
 
-- Fixed prompt errors when prompt text null or empty
-  [#236](https://github.com/PowerShell/Plaster/issues/236).
-- Fixed New Module Script template's Test task which fails to run on x64 Visual
-  Studio Code.
-- Fixed Test-PlasterManifest on non-Windows running .NET Core 2.0 failed with
-  path using \ instead of /. Thanks to
-  [@elmundio87](https://github.com/elmundio87) via PR
-  [#282](https://github.com/PowerShell/Plaster/pull/282)
+- Fixed issue with the use of `GetModule -FullyQualifiedName` on PowerShell v3
+
+## [1.0.0] 2016-12-16
 
 ### Added
 
-- Added constrained runspace cmdlet: Out-String
-  [#235](https://github.com/PowerShell/Plaster/issues/236).
-- Added constrained runspace variables: PSVersionTable and on >= PS v6 IsLinux,
-  IsOSX and IsWindows [#239](https://github.com/PowerShell/Plaster/issues/239).
-- The parameter element now supports a condition attribute so that prompting for
-  parameters can be conditional based on environmental factors (such as OS) or
-  answers to previous parameter prompts. This allows template authors to build a
-  "dynamic" set of prompts.
-- Added constrained runspace cmdlet: Compare-Object
-  [#286](https://github.com/PowerShell/Plaster/issues/287).
+- First official release shipped to the PowerShell Gallery
 
-### Changed
+## [0.3.0] 2016-11-05
 
-- Simplified New Module Script template user choices i.e. removed prompt for
-  adding Pester test. The test is now always added.
+### Added
 
-## 1.0.1 - 2016-12-16
+- Build script with support for building help from markdown files, building
+  updatable help files and generating file catalog
 
-- Fixed issue with the used of `GetModule -FullyQualifiedName` on PowerShell v3
+## [0.2.0] 2016-07-31
 
-## 1.0.0 - 2016-12-16
+### Added
 
-- First official release shipped to the PowerShell Gallery!
+- New directive `<templateFile>` that implicitly expands the specified file(s),
+  allowing the template author to set the target file encoding. This new
+  directive supports a wildcard source specifier like the `<file>` directive
 
-## 0.3.0 - 2016-11-05
+### Changed
 
-- Updated build script with support for building help from markdown files,
-  building updatable help files and generating file catalog.
-- Initial release shows the basics of what this module could do.
+- `<file>` directive no longer supports template expansion
+- Removed `template` and `encoding` attributes from `<file>` directive
+- Restructured the module source to follow best practice of separating
+  infrastructure from module files
 
-## 0.2.0 - 2016-07-31
+### Fixed
 
-- Introduced new directive `<templateFile>` that implicitlys expands the
-  specified file(s), allowing the template author to set the target file
-  encoding. This new directive supports a wildcard source specifier like the
-  `<file>` directive. With this change, `<file>` no longer supports template
-  expansion and as result the `template` and `encoding` attributes have been
-  removed.
-- Restructured the module source to follow best practice of separating
-  infrastructure from module files.
-- Fixed #47: How to create empty directories. The `<file>` directive supports
-  this now.
-- Fixed #58: File recurse does not work anymore.
+- How to create empty directories: the `<file>` directive supports this now
+  ([#47](https://github.com/PowerShell/Plaster/issues/47))
+- File recurse does not work anymore
+  ([#58](https://github.com/PowerShell/Plaster/issues/58))