All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.
v2.0.0 (2026-10-30)
Breaking Changes:
- require Elixir 1.20 across supported OTP versions by futhr
Features:
artifacts: verify admitted receipts without producer callbacks by futhr
artifacts: package structural schemas and independent contract vectors by futhr
artifacts: preflight complete batches before profile callbacks by futhr
json: check nesting before decoder allocation by futhr
presentation: validate portable page decorations and metadata by futhr
presentation: admit hosted narrative and OpenAPI pairs by futhr
presentation: validate shared site settings by futhr
Bug Fixes:
artifacts: enforce declared media and subject vocabularies by futhr
artifacts: require renderable anchors and fallback content by futhr
artifacts: localize selected manifest assets for file readers by futhr
presentation: keep reading flow within its declared view by futhr
deps: update the AshOaskit test fixture by Tobias Bohwalli
v1.0.0 (2026-10-23)
Breaking Changes:
- artifacts: reference module members from navigation by futhr
Features:
- presentation: admit portable artifact blocks by Tobias Bohwalli
Bug Fixes:
ci: isolate runtime caches and refresh pinned actions by Tobias Bohwalli
presentation: enforce portable artifact admission before export by Tobias Bohwalli
deps: update Decimal past security advisory by Tobias Bohwalli
Performance Improvements:
extraction: read module documentation concurrently by futhr
artifacts: write compact canonical artifacts encoded once by futhr
json: encode canonical json in a single pass by futhr
v0.5.0 (2026-10-10)
Features:
- site: publish renderer-neutral documentation sites by Tobias Bohwalli
Bug Fixes:
ci: isolate packaged consumers from inherited Mix paths by futhr
resolve patched Ash dependency by futhr
presentation: use portable redirect cycle tracking by futhr
deps: update Ash and Mint past security advisories by Tobias Bohwalli
deps: update Mint past its security advisory by Tobias Bohwalli
v0.4.0 (2026-09-16)
Features:
search: include module member documentation when explicitly enabled by Tobias Bohwalli
cache: expose consistent generation snapshots and reload timeouts by Tobias Bohwalli
collection: add portable documentation corpus provenance by Tobias Bohwalli
Bug Fixes:
cache: reject changed bytes under an active generation identity by Tobias Bohwalli
extraction: reject colliding module member metadata keys by Tobias Bohwalli
artifacts: contain encoder failures before publication by Tobias Bohwalli
collection: preserve exact JSON identity during reconstruction by Tobias Bohwalli
presentation: validate references and stabilize equal-title ordering by Tobias Bohwalli
collection: bound imports and reject ambiguous filesystem and JSON inputs by Tobias Bohwalli
artifacts: include stale deletion in publication rollback by Tobias Bohwalli
collection: validate complete provenance with indexed document identities by Tobias Bohwalli
validation: reject malformed input and ambiguous JSON encoding by Tobias Bohwalli
notebooks: run collection example after setup by Tobias Bohwalli
Performance Improvements:
collection: scan JSON syntax without per-byte allocation by Tobias Bohwalli
extraction: reuse parsed bodies for unfenced document titles by Tobias Bohwalli
v0.3.0 (2026-09-07)
Features:
- openapi: accept OpenAPI 3.2 source documents by Tobias Bohwalli
Bug Fixes:
include optional adapters in analysis by Tobias Bohwalli
build: stage output and restore failed publications by Tobias Bohwalli
artifact: define legacy generation compatibility by Tobias Bohwalli
cache: protect snapshots with process ownership by Tobias Bohwalli
cache: use registered names as supervisor child IDs by Tobias Bohwalli
changelog: preserve Markdown context across releases by Tobias Bohwalli
presentation: calculate each document path once by Tobias Bohwalli
search: preserve words across inline formatting by Tobias Bohwalli
generate: derive titles from parsed Markdown headings by Tobias Bohwalli
artifact: isolate temporary files across BEAM instances by Tobias Bohwalli
build: reject conflicting output destinations by Tobias Bohwalli
config: validate build options and guide fields by Tobias Bohwalli
presentation: validate recursive content and metadata by Tobias Bohwalli
json: normalize metadata without silent key collisions by Tobias Bohwalli
presentation: reject duplicate document identities by Tobias Bohwalli
guides: parse frontmatter delimiters by lines by Tobias Bohwalli
types: include recursive text nodes in the AST contract by Tobias Bohwalli
changelog: reject nil source entries by Tobias Bohwalli
openapi: include the default API version by Tobias Bohwalli
deps: update Mint and Ash past security advisories by Tobias Bohwalli
Performance Improvements:
- web: cache encoded responses and HTTP validators by Tobias Bohwalli
v0.2.0 (2026-09-01)
Features:
build: decouple host extraction from files and supervision by futhr
generate: extract changelog releases as documentation entries by futhr
Bug Fixes:
deps: support compatible AshOaskit hosts by futhr
build: report every generated document by futhr
generate: support conventional changelog releases by futhr
v0.1.0 (2026-08-24)
Features:
config: use notebooks as the default notebook source by Tobias Bohwalli
web: serve generated artifacts through a gated cache by futhr
mix: add the artifact build task by futhr
build: build the complete documentation artifact tree by futhr
config: resolve build settings from options, host config, and defaults by futhr
presentation: project content into typed presentation indexes by futhr
open_api: load OpenAPI documents through source adapters by futhr
generate: import Markdown guides and Livebook notebooks by futhr
generate: extract documentation from compiled modules by futhr
generate: share common document collection behavior by futhr
ast: parse Markdown into renderer-neutral syntax trees by futhr
json: coerce arbitrary terms into JSON-encodable values by futhr
artifact: store artifacts in versioned JSON envelopes by futhr
Bug Fixes:
notebooks: install DocShell in Livebook tutorials by futhr
package: remove the nonexistent changelog link by Tobias Bohwalli
deps: update Ash past security advisories by Tobias Bohwalli
cache: publish complete artifact generations atomically by futhr
Performance Improvements:
- bench: measure the parsing, projection, and artifact hot paths by futhr