タグ

ブックマーク / tbpgr.hatenablog.com (2)

  • 【緩募】Rubyリファレンス・マニュアル=るりまで不足中のサンプルコード8,000件を一緒に作りませんか? - Tbpgr Blog

    3行で説明すると Rubyは他言語に比べてリファレンスのサンプルコードが不足気味という意見があった 私が「やりましょう」と言った hanachin_ さんが調査スクリプトを作った結果ざっくり8,000件不足していることがわかった より詳しい話 もうちょっと詳しい流れはこのIssueにあります。 github.com 現状すでに多数のIssue, Pull Requestに話がまたがってしまっているので雑にまとめると サンプルコードをどのように書くかのガイドラインを私が作成済 サンプルコードはあるがそのままでは実行できないものがある hanachin_ さんが調査用の自作ツール+手作業で多数修正。完成率は不明 サンプルコードがないもの hanachin_ さん作成した調査ツールにより、調査開始時点で約8,000件あることがわかっている Rubyのrdocにサンプルがあるものはそのまま移植した

    【緩募】Rubyリファレンス・マニュアル=るりまで不足中のサンプルコード8,000件を一緒に作りませんか? - Tbpgr Blog
    fm315
    fm315 2017/09/18
  • Web APIのためのJSON Hyper-Schema - Tbpgr Blog

    Web APIのためのJSON Hyper-Schemaについて 2015/08/05追記。DeNAの清水直樹さんのスライドを追加しました JSON Hyper-Schemaについて 下記を参照 JSON Schema Official 必要性 APIの運用にはAPIドキュメントが必要 APIの実装とドキュメントの差異をなくす必要がある JSON Hyper-Schemaを活用することで以下のようなメリットがある DSL等で作成したクラスを元にJSON Schemaを生成することでコードとSchemaの整合性がとれる Schemaを元にAPIドキュメントを生成することができる Schemaを元にValidationが可能になる Schemaを元にClientアプリケーションの自動生成できる スライド GMOペパボの高橋健一さん DeNAの清水直樹さん JSON Schema と API

    Web APIのためのJSON Hyper-Schema - Tbpgr Blog
  • 1