Skip to content

Release hygiene: missing v3 changelog entry, hardcoded version field, untracked notes #92

Description

@morcen

Problem

Three hygiene items:

  1. CHANGELOG stops at v2.1.0 while composer.json declares v3.0.0, so upgraders find no v3 entry.
  2. composer.json hardcodes a version field, which Packagist advises against because a forgotten bump breaks tagging.
  3. Working notes (ISSUES.md, reddit.md, .claude/) sit untracked in the repo root and risk landing in a release commit.

Location

  • CHANGELOG.md
  • composer.json
  • Repo root

Fix

Write the v3.0.0 changelog entry, delete the version field, move notes out of the repo or add them to .gitignore.

Sizing

Priority 15 (Impact 2, Risk 1, Effort 1). Estimated 1-2 hours.

From the tech debt audit dated 2026-07-05.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationtech-debtFrom the technical debt register

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions