Skip to content

v1.0.0

Latest

Choose a tag to compare

@PeteBishwhip PeteBishwhip released this 03 Jul 22:45
Immutable release. Only release title and notes can be modified.
100cb1e

πŸŽ‰ Laradocs v1.0.0 β€” we're stable!

This is the big one. After the whole 0.x journey, Laradocs is officially 1.0.0 stable, with a frozen public API, a full migration path, and the feature we've been building towards for months: a native OpenAPI renderer.

Thank you to everyone who kicked the tyres through the pre-releases. Let's ship. πŸš€

✨ Highlights

πŸ“– Native OpenAPI renderer

The headline of this release. Laradocs now renders OpenAPI specs natively, no external doc UI required.

  • Pillars A & B land the core rendering engine (#140)
  • A redesigned reference layout with a request/response code-sample sidebar (#143)
  • Driver selection: pick native, Scramble, or auto and let Laradocs decide (#147)
  • Clean, summary-based operation slugs so your URLs read like docs, not hashes (#144)
  • A dedicated OpenAPI guide plus updated system requirements (#144, #141)

πŸ—‚οΈ Tabbed code blocks and content tabs

Group your bash / php / json samples into tabs, and organise longer pages with content tabs (#138).

🌍 Internationalisation

  • "Last updated" dates now localise to the active docs locale (#139)
  • Cookie consent integration so a reader's chosen language persists properly (#150)

πŸ”’ Stability and security

  • The public PHP API surface is now frozen (#149). From here, semver means what it says.
  • Security hardening around exec usage to close a potential RCE path (#154)
  • A new production readiness checklist (#151)
  • A full 0.x to 1.0 migration guide (#152)

⬆️ Upgrading from 0.x

Please read the migration guide in #152 before bumping. There are a small number of breaking changes tied to the API freeze, and the guide walks through each one.

What's Changed

New Contributors

  • @aikido-autofix[bot] made their first contribution in #154

Full Changelog: v0.6.1...v1.0.0