René's URL Explorer Experiment


Title: docs: add Slidev usergroup talk by mortik · Pull Request #52 · openapi-ruby/openapi-ruby · GitHub

Open Graph Title: docs: add Slidev usergroup talk by mortik · Pull Request #52 · openapi-ruby/openapi-ruby

X Title: docs: add Slidev usergroup talk by mortik · Pull Request #52 · openapi-ruby/openapi-ruby

Description: A ~15–20 min Slidev deck introducing openapi_ruby, under presentation/. Run it with cd presentation && pnpm install && pnpm dev. The slides are deliberately sparse — the content lives in the speaker notes, so read it in presenter view. Structure (15 slides): contract drift → OpenAPI 101 → the Rails landscape → the three subsystems (components, generation, validation) → strong params & Swagger UI → why it can't drift. Reviewed against the code at v4.1.0 Every code sample and claim in the deck was checked against lib/: OpenapiRuby::Components::Base, schema(...), inheritance deep-merge, class refs — match components/base.rb and the README examples. path/get/response/run_test! and the style-2 api_path + assert_api_response DSL — match adapters/rspec.rb and adapters/minitest.rb. :enabled / :disabled / :warn_only, bad request → 400, bad response → 500, off by default — match configuration.rb and middleware/error_handler.rb. openapi_permit, mount OpenapiRuby::Engine, config.ui_enabled, rake openapi_ruby:generate — all current. The slide-7 full_name example does camelCase correctly, including inside required (key_transformer.rb special-cases that array). Two things drifted and are fixed here: the title slide said v4.0.1, and the style-2 speaker notes didn't mention the 4.1.0 AmbiguousApiPath behaviour — worth having on hand since that slide is where the question comes up. One claim I could not verify from this repo: the speaker note on the landscape slide says rswag is still 3.0-only and seeking maintainers. That was true when the deck was written — worth a quick check before presenting. Also cleaned up Removed the original Slidev export (slidev/ and its zip) — a stale near-duplicate of the runnable slides.md. Removed the unused @slidev/theme-seriph dependency (the deck is theme: none). Fixed the README's theme section, which described an inline