docs: add a scriv-managed changelog by Unisay · Pull Request #7 · purescript-lua/purescript-lua-ngx · GitHub
Skip to content

docs: add a scriv-managed changelog#7

Merged
Unisay merged 2 commits into
mainfrom
issue-101/scriv-changelog
Jun 25, 2026
Merged

docs: add a scriv-managed changelog#7
Unisay merged 2 commits into
mainfrom
issue-101/scriv-changelog

Conversation

@Unisay

@Unisay Unisay commented Jun 25, 2026

Copy link
Copy Markdown
Collaborator

docs: add a scriv-managed changelog

Brings ngx in line with the rest of the ecosystem: a CHANGELOG.md managed with scriv, scriv in the flake dev shell, and an AGENTS.md release note that points at the scriv flow.

What

  • New CHANGELOG.md with the scriv markers, backfilling v0.1.0 (the initial OpenResty bindings) and v0.2.0 (the toolchain refresh).
  • changelog.d/scriv.ini config, plus scriv in the dev shell.
  • A pending fragment for the work that has no tag yet: the new-spago migration and the scripts/run OpenResty runner. It folds into the next release when someone runs scriv collect.
  • The AGENTS.md "Releasing" section now says to write a fragment and run scriv collect, instead of "no changelog entry".

Nothing under src/ changed, so this needs no tag or set bump.

Part of purescript-lua/purescript-lua#101. The reasoning is in package-set ADR 0009.

Adds a CHANGELOG.md managed with scriv (fragments in changelog.d/), provides
scriv in the flake dev shell, backfills the v0.1.0 and v0.2.0 releases, and
captures the unreleased new-spago migration and scripts/run runner as a pending
fragment. The AGENTS.md Releasing note now points at the scriv flow.

Part of the ecosystem-wide changelog adoption
(purescript-lua/purescript-lua#101); canon in package-set ADR 0009.

Copilot AI left a comment

Copy link
Copy Markdown

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 Scriv-managed changelog workflow to align purescript-lua-ngx with the broader ecosystem: a new CHANGELOG.md seeded with historical releases, Scriv configuration + an initial fragment, and updated release guidance in AGENTS.md.

Changes:

  • Add CHANGELOG.md with Scriv markers and backfilled entries for v0.1.0 and v0.2.0.
  • Introduce Scriv config (changelog.d/scriv.ini) and a pending fragment (changelog.d/0001-...).
  • Update AGENTS.md release process to include writing fragments and running scriv collect.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
flake.nix Adds Scriv to the dev shell toolset (needs attribute-path fix).
CHANGELOG.md New Scriv-managed changelog with backfilled historical releases.
changelog.d/scriv.ini Scriv configuration to match Keep a Changelog-style headings/titles.
changelog.d/0001-new-spago-and-run-script.md Pending changelog fragment for upcoming release collection.
AGENTS.md Updates release instructions to use Scriv + changelog fragments (branch name needs correction).

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

Comment thread flake.nix
Comment thread AGENTS.md Outdated
Addresses Copilot review on PR #7: the Releasing note inherited the fork
template's `master`, but ngx's default branch is `main`.
@Unisay Unisay merged commit b0fb52e into main Jun 25, 2026
1 check passed
@Unisay Unisay deleted the issue-101/scriv-changelog branch June 25, 2026 08:58
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