Skip to content

v2.0.0

Choose a tag to compare

@ovac ovac released this 02 Sep 04:50
· 23 commits to master since this release

v2.0.0 — Hybrid Redoc + Swagger “Try it” • CDN fix (breaking)

🚨 Breaking

  • All prior versions are no longer functional because the legacy Redoc CDN was discontinued.
    This release switches to a supported Redoc bundle and introduces a new hybrid docs view. Upgrade is required.

✨ What’s new

  • Hybrid docs view: Redoc OSS for reading + a slide-in Swagger UI “Try it” panel.
  • Context-aware console:
    • Follows Redoc links (#/tag/... and #/tag/.../operation/...).
    • When scrolling, detects the visible tag/operation and updates the console automatically.
  • Extra request headers (JSON): Add arbitrary headers (e.g., {"X-Tenant":"acme"}) in the panel header.
    Persisted to localStorage and injected into every Swagger request.
  • Click-to-copy & Download: One-click copy of response JSON and a Download button on Swagger responses.
  • Cleaner Swagger header: Reduced title size for a tighter look.
  • Extensive inline documentation in the Blade view to explain selectors, options, and fallbacks.

🛠 Fixes

  • Redoc CDN 404 (e.g., Not found: /@redocly/reference-docs.../redoc.standalone.js).
    Now using https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js.

🔧 Changed

  • Updated default Markdown intro to document the hybrid model, quick start, and tips.
  • Safer fetch normalization that adds Accept: application/json to /api calls when missing.

📦 How to upgrade (required)

  1. Update package
    composer update ovac/idoc
    

What's Changed

New Contributors

  • @dandelosreyes made their first contribution in #45
  • @hassaans208 made their first contribution in #48

Full Changelog: v1.7.0...v2.0.0