From cd3abdc6d8af53708f69c2371eb116de160bfbf5 Mon Sep 17 00:00:00 2001 From: JohnnyT Date: Mon, 5 Oct 2026 06:18:51 -0600 Subject: [PATCH] Prepares the 9.4.3 release `@version` moves to 9.4.3 and `CHANGELOG.md` gains a dated 9.4.3 section. Everything on main since v9.4.2 is documentation, docs configuration, the gate and the release workflow; no file under lib/ or conformance/ changed, so the release is a patch. Documentation takes no `changelog.d/` fragment here and the recipe has no Unreleased section to promote, so the section is written by hand (ruled by the operator, 2026-10-05). It names what a reader of the package sees: the hexdocs sidebar grouped by kind of page, the new explanation page, the README rewritten as an introduction with a documentation map, the README examples moved into the language reference, and the README-linked pages now shipping in the package. The gate, release workflow and dev dependency changes are not user facing and get no bullet, per `changelog.d/README.md`. A patch bump, so the README install pin (`~> 9.4`) does not move. No tag is created here; the tag push publishes through the release workflow. Refs: px-g93q --- CHANGELOG.md | 26 ++++++++++++++++++++++++++ mix.exs | 2 +- 2 files changed, 27 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9b3944d..3b8b3fd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,32 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [9.4.3] - 2026-10-05 + +A documentation release: no library code changes, and a program compiles and +evaluates exactly as it did in 9.4.2. + +### Documentation + +- The hexdocs sidebar groups its pages by kind: How-to guides (custom + functions, embedding compiled programs, porting), Reference (the language, + the AST, the instruction set, nested data access, location expressions, the + simple subset) and Explanation (the architecture, and the new page below), + with the README and this changelog ungrouped at the top. The three how-to + guides' titles now start "How to"; no file is renamed. The contributing + guide and the license are no longer hexdocs pages; both still ship in the + package and the README links them on GitHub. +- A new page, "Why a predicate language of its own", explains who writes a + rule and who executes it, the alternatives turned down, and what the + language buys and costs. +- The README is rewritten as an introduction: what the package is, why it + exists, the install line, one basic usage example, and a documentation map + grouped by the reader's question. The short-program and editor-vocabulary + examples it carried move into the language reference, as "Running a program + from Elixir" and "The vocabulary for an editor". +- Every page the README links to relatively now ships in the package, so the + links resolve on the hex.pm package page as well as on GitHub and hexdocs. + ## [9.4.2] - 2026-09-22 ### Fixed diff --git a/mix.exs b/mix.exs index f7a42bc..d6b8d66 100644 --- a/mix.exs +++ b/mix.exs @@ -2,7 +2,7 @@ defmodule Predicator.MixProject do use Mix.Project @app :predicator - @version "9.4.2" + @version "9.4.3" @description "A secure, non-evaling condition (boolean predicate) engine for end users" @source_url "https://github.com/riddler/predicator-ex" @deps [