Wordな職場にSwaggerを定着させようとして失敗したけど結局定着した話 - Qiita

はじめに 私の職場では、WebAPIの仕様書をWordで書く習慣があったのですが、2018年頃にSwaggerで書くように切り替わったので、そのように変化した経緯を書きます。 何かの参考になれば幸いです。 ちなみに、こちらの記事と同じ職場です。 Wordな職場にMarkdownを定着させるためにやった４つのこと Swaggerとは？ Swaggerとは、REST APIの仕様を定義するためのフォーマットです。その周辺技術も含めて、Swaggerと呼ばれます。以下の記事が非常に参考になりますので、詳細を知りたい方はご参照ください。 Swaggerの概要をまとめてみた。 Swagger 導入失敗 2016年頃のある日、上司から「世の中にはSwaggerというものがあるらしい。調べてもらえる？」と指示されました。 調べてみたところ、Swaggerがあれば、WebAPIのドキュメントサイトも作れる

[sm_0310]

Swaggerがチーム内に定着しなくて、そもそもこいつらRESTの仕様わかってんのか？って発想の転換できるこの人すごい

[circled]

VSCodeが妙にすごい。最近のMicrosoftおかしい。

[TakamoriTarou]

高度なCADシステムを導入したら、従来の書き方ができないぞ！と苦情が入り、調べたらJIS/ISO/ANSI/DINなどの公的規格に一切ないクソ方言だった話を思い出した。カスタマイズしろと言う輩を外部講師招いて黙らせたそうで

[sdkd6611]

ツールに振り回されてはいけないみたいな話を変に捉えて、今現在のありのままから全く変えようとしないしツール使っても思想に全く合わない適当な使い方をするみたいなの多い

[paradisemaker]

word の api仕様書とか発狂しそう

[yoiIT]

この一文読んだだけで吐いた。＞“私の職場では、WebAPIの仕様書をWordで書く習慣があった”

[threewaygood]

今後使いたい

[an_emerald]

そもそもWordがつらい…

[vanbraam]

おまけがむしろ重要で,こういう事の為にSwaggerとかOpenAPI Specificationとか使うんだと思う;ClientとServerの自動生成は使い所がかなり難しい(特にServer);GraphQL時代になるとまた変わるんだろうな色々と

[RabbitBit]

信頼を築き、環境を築き、導入に至らせる。この経験談は、悩める職場の改革者には、響くものがあると思う。

[field_combat]

諦めないのすごいな

[diveintounlimit]

すげー努力家だ。。「日本のIT業界の問題が凝縮されており」全くそのとおりだ。。

[D_first]

弊社ではwebといえばjspがセットになっているもので、web apiという発想がそもそも無い。データ連携はバッチ処理。restなんて言葉は誰も知らない。

[naopi_chan]

Swaggerに馴染めなくてAPI Blueprintで書いた経緯あるので参考になる。 あ、普段はExcel方眼紙なAPI仕様書です(吐血

[a96neko]

そもそもwordでドキュメントを作りたくないな

[sudow]

諦めずに説得しつづけるのはすごいなあ、、、

[richard_raw]

新技術をきちんと定着させられたのすごいです（小並感）。

[AyeBee_TY]

そもそもMarkdownを理解できない、WYSIWYGじゃないと操作できない（HTMLすら怪しい）ひとばかりで、Excel設計書から脱却できなくてつらい。

[zaki-hmkc]

一度は定着しなくても技術力と根気で再定着するのすごい。。

[lalupin4]

スワガーってなんぞ？

[HolyGrail]

えらい

[Phenomenon]

いやいやいって解決策を探さない人たちはエンジニアとは呼びたくないよね。

[otihateten3510]

頑張ったな

[u-north]

ワードは青でパワポは赤いの性的差別を感じる

[MasaoBlue]

すごいなぁ。地道な努力

[kenichi_odo]

Wordの仕様書ぱない

[yarumato]

“Swaggerを導入して1年以上経ちましたが、以下の効果を実感。 仕様書の更新漏れがなくなる。仕様書、WebAPIのインフラの設定、テストクライアントが個別に管理しないため不整合を解消”

[sho]

いい話だ

[rrringress]

すてきっす

[tekimen]

すごい

[masatotoro]

swagger editor

[sharaku3eyes]

アツイ

[indication]

相手に合わせて提案、改善できてるのすごい

[Helfard]

ｲｲﾊﾅｼﾀﾞﾅｰ。