Immutable
release. Only release title and notes can be modified.
π 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, orautoand 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
execusage 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
- feat: tabbed code blocks and content tabs by @PeteBishwhip in #138
- feat: localize "Last updated" date using the active docs locale by @PeteBishwhip in #139
- feat: OpenAPI native renderer (Pillars A & B) by @PeteBishwhip in #140
- docs: add OpenAPI package requirements to system requirements by @PeteBishwhip in #141
- feat: redesign OpenAPI reference + request/response code-sample sidebar by @PeteBishwhip in #143
- docs + feat: OpenAPI guide, plus clean summary-based operation slugs by @PeteBishwhip in #144
- feat: OpenAPI generator driver selection (native / Scramble / auto) by @PeteBishwhip in #147
- New Crowdin updates by @PeteBishwhip in #146
- Freeze the public PHP API surface by @PeteBishwhip in #149
- i18n: cookie consent integration for language persistence by @PeteBishwhip in #150
- docs: add production readiness checklist by @PeteBishwhip in #151
- Add migration guide: 0.x β 1.0 by @PeteBishwhip in #152
- docs: v1.0 release prep (changelog, README badges) by @PeteBishwhip in #153
- [Aikido] AI Fix for Unsafe exec usage can lead to remote code execution by @aikido-autofix[bot] in #154
New Contributors
- @aikido-autofix[bot] made their first contribution in #154
Full Changelog: v0.6.1...v1.0.0