25000行超えのAPIドキュメントを分割した話

2024/03/22 54 users APIドキュメント OpenApi 知見 伊藤 弊社

はじめに COUNTERWORKSバックエンドエンジニアの伊藤です。 この記事ではAPIドキュメント分割の知見を紹介します。 弊社では OpenAPI を使用したスキーマ駆動開発を採用しています。 1ファイルで管理していたところ、25000行を超える行数となり管理コストが高くなっていました。 そこで分割作業を実施したのですが、どの... 続きを読む

TypeScriptプロジェクトにスキーマ駆動開発を持ち込み、より型安全な世界へ - Sansan Tech Blog

2023/08/14 22 users TypeScriptプロジェクト TypeScript

Bill One Entry*1グループの秋山です。 本題に入る前にお知らせです。9/12 (火) にTypeScriptを活用した型安全なチーム開発をテーマとしたイベントを開催します。 ぜひ、お気軽にご参加ください！ sansan.connpass.com 1. はじめに 1-1. スキーマ駆動開発とは 1-2. Testing Trophyとの関係性 2. 構成 2-1. 最初の構成と... 続きを読む

いかにして GraphQL を組織に導入するか (新規開発編) / how we introduce GraphQL on scratch development

2022/08/31 57 users GraphQL qsona How we Links 組織

いかにして GraphQL を組織に導入するか (新規開発編) / how we introduce GraphQL on scratch development GraphQL Tokyo #18 Lightning Talks https://www.meetup.com/ja-JP/graphql-tokyo/events/286913987/ Links: [GraphQL を活用したスキーマ駆動開発の実践](https://speakerdeck.com/qsona/schema-driven-develop... 続きを読む

Gaudiyのプロダクト戦略とGraphQLの活用 - Gaudiy Tech Blog

2021/10/20 11 users GraphQL Gaudiy 浮き彫り 永井 エンジニア

こんにちは！Gaudiyのエンジニアの永井（@sho0910K）です。 Gaudiyでは昨年からGraphQLを導入し、スキーマ駆動開発に取り組んできました。導入からまもなく1年を迎えようとしていますが、良かったところや、改めて浮き彫りになった課題や気づきがあったので、今回はGraphQLの取り組みについてまとめてみたいと思います。... 続きを読む

TypeScriptとOpenAPIスキーマで型安全に　READYFORが語る“スキーマファースト”で効率的な開発方法 - ログミーTech

2021/04/14 28 users ReadyFor TypeScript 登壇 菅原氏 ツール

「実践！フロントエンド分離戦略」はREADYFOR 株式会社主催のエンジニア向けLT勉強会です。ここで、菅原氏が「OpenAPI GeneratorとTypeScriptによる型安全なスキーマ駆動開発」のタイトルで登壇。スキーマ駆動開発とそのメリット、活用しているツールについて話します。 READYFORのフロントエンジニア 菅原弘太郎氏（以... 続きを読む

Rails + RSpec + OpenAPI3 + Committeeでスキーマ駆動開発を運用するTips - Timee Product Team Blog

2020/07/07 22 users committee Rails rspec 宮城 Tips

こんにちは、タイミーデリバリー開発チームの宮城です。 今回は弊社のOpenAPI3ベースのスキーマ駆動開発の運用方法を紹介します。 TL;DR 技術スタックは OpenAPI3, Swagger UI, Committee, ActiveModelSerializers Committeeを利用してOpenAPI準拠のRequest Specを行う OpenAPI3のrequiredキーワードに注意する 背景 タ... 続きを読む