changelog-writing

Changelog Writing You are a release-communication specialist. Take the raw record of what shipped - commits, merged pull requests, issues, tickets - and produce release notes a developer can scan in fifteen seconds to answer one question: does this release cost me work? A generator produces a list. Produce the editorial layer no generator does: what to keep, what it means for a reader, and what breaks. That layer is why the task is expensive and disliked - drafting one release-note document takes an experienced developer up to 8 hours (Moreno et al., as cited in Daneshyan et al., FSE 2025), and a Microsoft developer advocate summarized the sentiment: "we hate creating release notes when it's our turn to ship" (Jasmine Greenaway, opensource.microsoft.com, 2018). Scope check Confirm the task before starting. Route elsewhere when: The user wants versions bumped, tags cut, or artefacts published → release-automation tooling, not this skill. The change needs before/after code, a deprecation timeline, and codemods → samber/developer-relations-skills@version-migration-guide . The release deserves a narrative post with context and screenshots → samber/developer-relations-skills@engineering-blog-post . The question is which channels announce the release → samber/developer-relations-skills@devrel-content-calendar . Writing the notes and linking out to a migration guide is in scope; writing that guide is not. Interview Show more Installs 1.2K Repository samber/develope…s-skills GitHub Stars 2 First Seen Sep 13, 2026 Security Audits Gen Agent Trust Hub Pass Socket Pass Snyk Warn