ドキュメントとコードが乖離しないように DMM .com のエンジニアが教えるGoaを使ったAPIサーバーの作りかた

DMM Groupのエンジニアが、Goを活用したプロダクト事例やトレンド、現場のリアルを話すイベント「DMM.go」。2回目の今回は、DMM.com プラットフォーム事業本部 エンジニアの本田雄亮氏が、Goaを使ってAPIサーバーを作る方法について紹介しました。関連資料はこちら。 手作業のドキュメントとコードとは乖離する 本田雄亮氏：今回、「Goaを使ってAPIサーバー開発してみた」というタイトルでお話ししたいなと思います。 まず自己紹介です。プラットフォーム部というところで基盤システムの開発をしています。バックエンドのエンジニアです。名前は本田です。興味あるのは、Goとかアーキテクチャ。DDDとかがけっこう好きなので、もし懇親会に参加される方がおられたら、Goaだけの話じゃなくて、Go全般だったりアーキテクチャ、DDDまわりでもお話できたらなと思っています。 さっそくメインテーマのGoa

[ken39arg]

web APIやRPCなどの外側の部分はprotobufやswaggerを使ってドキュメントからコード生成をして、内部使用に関してはコメントやドキュメントを極力書かずにひたすらわかりやすいコードを書くで、俺の中では決着してる

[knok]

GoogleはgRPCで頑張っていそう

[golden_eggg]

goaいいよね

[cartman0]

これのpython版ないんか？

[damedog]

コードとの乖離が問題になり、コードからドキュメントを生成するとドキュメント先行の開発ができず。どう足掻いても、ドキュメントないし、DSLで書いて、ドキュメントもコードも生成型でしかできないものか。。。