はじめにこんにちは、Finatext で保険事業のプロダクト開発をしている @toshipon です。今回は以前の Fin-JAWS のイベントで少し紹介させていただいた、我々の現場で取り組んでいる、大規模API開発における Swagger を用いたAPI仕様のドキュメント運用方法について紹介いたします。 概要我々の現場では、API ベースのWeb Application を開発する際に、Swagger を用いて API 設計をしたり、BFFサーバー開発者やフロントエンド開発者とのコミュニケーション手段として活用しています。 ただし、Web Application の規模が大きくなってくると、Swagger の 定義ファイルは肥大化してしまい、メンテナンスが困難になってきます。 今回は、Web Application の規模が大きくなっても耐えうる Swagger 定義ファイルの運用方法を

随分と久しぶりに、完全書き下ろしの本を書きました。 タイトルは、「人生がうまくいかないと感じる人のための超アウトプット入門 」。 アウトプットすることの意義、そしてその能力の源泉についての話を、読みやすいよう、物語形式にてまとめています。 どうか買ってやっていただけると、とてもありがたく、温かい投げ銭をよろしくお願いします。 アウトプットは「他者からの評価」の部分にキモがある。 さて、この本にちなんだ話題です。 先行き不安な世相を反映してか、世の中には「アウトプットの手法」に関するノウハウが氾濫しています。 ちょっと書店を見渡すだけで、 「アウトプット術で仕事がうまくいく」 「アウトプット力で成功」 「アウトプットスキルで差をつける」 などの、本が驚くほど多数、陳列されているのです。 そして、中身を見ると、書き方、話しかた、表情の作り方、報告の仕方など、「やるべきことと、その方法」が羅列し