面倒なドキュメント生成はCIにやらせよう - Gunosy Tech Blog

2021/12/25 15 users JupyterHub koid EKS Adventar 更新

こんにちは、koidです。 この記事は Gunosy Advent Calendar 2021 - Adventar の25日目の記事です。 昨日の記事は aitaさんの EKSにJupyterHubを構築した - Gunosy Tech Blog でした。 ドキュメントの更新って面倒だし忘れがち ドキュメントのメンテナンスを自動化しよう コードからドキュメントを自動生成する ツールの... 続きを読む

JSON Schema 中心設計 - FlowType から RAML まで - - Qiita

2017/09/19 90 users RAML Flowtype Qiita バリデーション API

はじめに Web サービスの運用を続けていくと，依存関係が徐々に複雑になっていきます．そしてメンテナンスするものが増えた結果，それらが相互に乖離していく，といったことが起こりがちです． そこで今回は，JSON Schema のみをメンテナンスしていくことで，動的チェック (バリデーション)，静的チェック (FlowType)，API ドキュメント生成，スタブ作成といった様々な恩恵を享受し，品質と保... 続きを読む

僕が考えた最強のAPIドキュメント生成 - 銀の人のメモ帳

2016/02/16 320 users 最強 メモ帳 request RAML JSON

2016 - 02 - 16 僕が考えた最強のAPIドキュメント生成 TL; DR ドキュメント生成には kevinrenskers/raml2html を使った ドキュメントは RAML - RESTful API modeling language で書いた RAMLには JSON Schema と JSON を記載できる API で返ってくる JSON は Rails アプリのrequest... 続きを読む

Railsのテスト,デプロイ,ドキュメント生成をBitbucket, Jenkins で行う - ボクココ

2014/04/15 114 users Jenkins Rails bitbucket デプロイ 連携

2014-04-14 Railsのテスト,デプロイ,ドキュメント生成をBitbucket, Jenkins で行う 今回はJenkinsとBitbucket の連携をします。 Bitbucket はプライベートリポジトリを何個でも作れて、5人までなら無料で使えるという優れもの。少人数開発ならこれを使わない手はないです。 Github Enterprise だとお金かかる部分が浮きます。 さらに！ ... 続きを読む