Changelog

Each build of these docs takes the kernel’s OpenAPI document and registry, diffs them against the previous build, and records what was added, removed and changed: operations, actions, object types and their properties, link types, webhooks. A removal is marked breaking. Notes written by hand sit on the same entries. The reference pages are generated from the same document, so a change listed here is already reflected there.

A deprecation is announced here before it takes effect, with the date it will be removed and what to use instead.

7 November 2026

contract 0.0.1additive

• The developer docs move to developers.aerandil.com, their own origin, with the sidebar on every page and an llms.txt index for agents. Every page is also served as Markdown by adding .md to its URL.
• New pages: Usage guidelines (the four routes every action has, idempotency semantics, the error envelope, pagination and rate limits), Events and webhooks (the polling and streaming shapes, the receiver contract), Use cases, and Contact support.
• Corrected: the Quickstart and the ontology model page described an If-Match header and a 412 response. There is no generic write on an object, so neither exists; conflicts surface as 409 from the action that refused the change.
• From this entry on, changes to the contract are recorded here automatically: each docs build diffs the OpenAPI document and the registry against the previous build and writes what was added, removed and changed.