Skip to content

Releases

v2.3.0

Choose a tag to compare

@tsitsishvili tsitsishvili released this 01 Nov 17:18
ac02729

What's Changed

Full Changelog: v2.2.1...v2.3.0

v2.2.1

Choose a tag to compare

@tsitsishvili tsitsishvili released this 24 Oct 17:22
6a4792d

accepts a bodyless 204 success response without requiring a schema

v2.2.0

Choose a tag to compare

@tsitsishvili tsitsishvili released this 11 Aug 19:44
91c3a78

What's Changed

Full Changelog: v2.1.0...v2.2.0

v2.1.0

Choose a tag to compare

@tsitsishvili tsitsishvili released this 24 Jul 09:16
bd51006

What's Changed

Full Changelog: v2.0.3...v2.1.0

v2.0.3

Choose a tag to compare

@tsitsishvili tsitsishvili released this 17 Jul 07:50
92c4d6c

What's Changed

Full Changelog: v2.0.2...v2.0.3

v2.0.2

Choose a tag to compare

@tsitsishvili tsitsishvili released this 16 Jul 17:24
c3d9abc

Documentator v2.0.2

This maintenance release restores complete release history after v2.0.1 was published without its required changelog entry.

Included v2.0.1 improvements

  • Refined the built-in explorer with softer dark surfaces, borders, shadows, and response panels.
  • Enabled automatic text detection and LF line-ending normalization through .gitattributes.

Release metadata

  • Added accurate changelog entries for v2.0.1 and v2.0.2.
  • Verified the release tag against the changelog before publication.

Full Changelog: v2.0.1...v2.0.2

v2.0.1

Choose a tag to compare

@tsitsishvili tsitsishvili released this 16 Jul 17:14
cc99e88

What's Changed

Full Changelog: v2.0.0...v2.0.1

v2.0.0

Choose a tag to compare

@tsitsishvili tsitsishvili released this 16 Jul 15:35
3d19be6

Documentator v2.0.0

This major release upgrades generated API descriptions to OpenAPI 3.2 and adds first-class support for the HTTP QUERY method.

Highlights

  • Added end-to-end HTTP QUERY support across generation, validation, contract diffs, section filtering, Postman exports, the built-in explorer, try-it requests, and code snippets.
  • Upgraded generated documents from OpenAPI 3.1 to OpenAPI 3.2.
  • Reworked portable, Codex, Gemini, Cursor, Boost, and Agent Skills guidance with tested, tool-specific workflows.
  • Added a dedicated v2 upgrade guide and cleaned Composer release archives so development-only files are excluded.

Upgrade notes

Existing Laravel routes, configuration, namespaces, and Documentator attributes require no source changes. Before upgrading, confirm that every downstream OpenAPI consumer supports OpenAPI 3.2.

composer require "tsitsishvili/documentator:^2.0" --with-all-dependencies

See the v2 upgrade guide for the complete migration and rollback checklist.

Full Changelog: v1.8.0...v2.0.0

v1.8.0

Choose a tag to compare

@tsitsishvili tsitsishvili released this 13 Jul 09:40
bd92ede

Documentator v1.8.0

This release makes Documentator's inference more accurate, explainable, and
better suited to OpenAPI contract enforcement.

Highlights

  • Added documentator:explain METHOD URI to show which extraction strategies
    produced each parameter, field, and response. Use --json for tooling.
  • Added --fail-on=breaking to
    documentator:check --against=<spec>, allowing additive changes while
    rejecting breaking contract changes.
  • Added inference for responses produced by abort, abort_if,
    abort_unless, authorization checks, and recognized HTTP exceptions.
  • Added PHP 8.5 to the test matrix.

Schema improvements

  • Resource fields are now marked required more accurately.
  • Conditional when* and mergeWhen fields are optional instead of nullable.
  • Resource composition preserves field descriptions, @var types, and
    examples.
  • Spatie Data schemas respect input/output name mapping and Optional or
    Lazy properties.
  • Distinct responses sharing a status code are represented with oneOf.
  • OpenAPI comparison now follows local references and checks constraints,
    nullability, composites, headers, security scopes, and additional
    properties.

Upgrade notes

This release has no intended package-level breaking changes. However,
regenerated OpenAPI documents may change because required fields, conditional
fields, error responses, and same-status response branches are now modeled more
accurately. Review the generated contract diff before updating committed
specifications or generated clients.

composer require tsitsishvili/documentator:^1.8

Full Changelog: v1.7.1...v1.8.0

v1.7.1

Choose a tag to compare

@tsitsishvili tsitsishvili released this 06 Jul 17:58
355867b

What's Changed

Full Changelog: v1.7.0...v1.7.1