Skip to content

docs: add retroactive CHANGELOG.md#181

Merged
HeyItsGilbert merged 3 commits into
mainfrom
docs/retroactive-changelog
May 21, 2026
Merged

docs: add retroactive CHANGELOG.md#181
HeyItsGilbert merged 3 commits into
mainfrom
docs/retroactive-changelog

Conversation

@HeyItsGilbert
Copy link
Copy Markdown
Member

@HeyItsGilbert HeyItsGilbert commented May 21, 2026

Summary

  • Adds a CHANGELOG.md at the repo root, reconstructed retroactively from the git history of PSDepend/PSDepend.psd1.
  • Covers every published version from 0.0.1 (2016-07-29) through 0.3.0 (2018-09-20), plus an [Unreleased] section capturing the large queue of work merged since 0.3.0 (PSResourceGet, Chocolatey, Pester v5 migration, build modernization, numerous bug fixes — PRs Adding check for empty string as well as null #102 through feat(build): add InstallLocal psake task for local pre-release installs #180).
  • Follows Keep a Changelog with Added / Changed / Fixed groupings and SemVer headings.
  • Resolves the dangling reference in PSDepend/PSDepend.psd1 (line 109), where PrivateData.PSData.ReleaseNotes already points at CHANGELOG.md on main but the file did not exist.

Why retroactive

The module has shipped 8 versions but never carried a changelog. Reconstructing it now gives a single place to read project history, makes the existing ReleaseNotes link resolve, and creates a landing spot for future releases to append to instead of starting from scratch.

Test plan

  • Verify CHANGELOG.md renders correctly on GitHub.
  • Confirm the URL in PSDepend/PSDepend.psd1 line 109 (ReleaseNotes) now resolves once merged to main.
  • Spot-check a couple of historical entries against git log to confirm accuracy.

🤖 Generated with Claude Code

Reconstructs release history from git log of PSDepend/PSDepend.psd1,
covering 0.0.1 through 0.3.0 plus an [Unreleased] section for work
merged since the last published release. Format follows Keep a
Changelog; the file path matches the ReleaseNotes URL already
referenced in PSDepend.psd1.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 21, 2026 03:09
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a root-level CHANGELOG.md intended to retroactively document PSDepend’s release history and provide a valid target for the module manifest’s existing PSData.ReleaseNotes URL.

Changes:

  • Introduces CHANGELOG.md following a Keep a Changelog-style structure with an [Unreleased] section and historical versions.
  • Captures reconstructed release notes for versions 0.0.1 through 0.3.0 and summarizes post-0.3.0 work.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread CHANGELOG.md Outdated
- NuGet is now bootstrapped lazily, only when a `Nuget`/`PSGalleryNuget` dependency is used (#175).
- Renamed default branch references from `master` to `main`.
- Updated `README` and examples for `PowerShellOrg` ownership.
- Allowed overriding the dependency name in the `Github` dependency type (#121).
Comment thread CHANGELOG.md Outdated
- `Import-PSDependModule`: sanitize the version string passed to `Import-Module` (#140).
- `Git`: use the full `Dependency.Target` path when the target doesn't exist (#169).
- `Git`: remove dependency on the `git.exe` extension for cross-platform support.
- `Github`: speed up downloads by suppressing `Invoke-RestMethod` progress (#122).
Comment thread CHANGELOG.md
- Tests now use `TestDrive` instead of `TargetPath`.
- `psake` build task allows `psd1` version overrides.
- Unmarked `Github` as experimental.
- Honor arbitrary target path logic for `Github` types.
Comment thread CHANGELOG.md
## [0.1.49] - 2017-03-19

### Added
- `Github` dependency type with default target handling.
Comment thread CHANGELOG.md Outdated
- `AcceptLicense` for `PSRepositoryModule`.
- `Nuget` dependency type for pulling packages from arbitrary NuGet feeds, with custom DLL name support and `exe` support.
- Credential support across PSGallery scripts (`PSGalleryModule`, `PSGalleryNuget`) and `Invoke-PSDepend`; credentialed NuGet feed search; credential misconfiguration warning.
- `Funding.yml`.
Comment thread CHANGELOG.md Outdated
- `Chocolatey` provider and accompanying Pester tests.
- SemVer / prerelease handling, including a PowerShell version constraint to avoid conflicts with the native `SemanticVersion` class in PS 6+.
- `AcceptLicense` and `AllowPrerelease` parameters on `PSGalleryModule` (passed only when specified).
- `AcceptLicense` for `PSRepositoryModule`.
Drop PR-number citations in favor of self-contained, technically
specific bullets that describe the actual code change (file/function/
parameter names, behavior contracts, migration notes) — establishing
the style going forward.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Keep the descriptive style but cite PR numbers in parens at the end of
each bullet where a PR exists in the commit history.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@HeyItsGilbert HeyItsGilbert requested a review from Copilot May 21, 2026 03:20
@HeyItsGilbert HeyItsGilbert merged commit da16223 into main May 21, 2026
1 check failed
@HeyItsGilbert HeyItsGilbert deleted the docs/retroactive-changelog branch May 21, 2026 03:20
@HeyItsGilbert HeyItsGilbert review requested due to automatic review settings May 21, 2026 03:42
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.

2 participants