yanom blog

様々な技術について書きます

設計のための、問題の捉え方

というタイトルの良スライドを読んだので、個人用にまとめておきます。

参考

設計のための、問題の捉え方

やっていき

  • コードには How
  • テストコードには What
  • コミットログには Why
  • コードコメントには Why not
    • コメントのwhy notというのは、「なぜ別のやり方を採用しなかったかの説明」という意味

まとめ

  • 問題を捉える

    • 未知のこと
    • データ
    • 条件
      • ドメイン知識が暗黙知になっている
        • ドメイン知識:取り組んでいる分野、領域
        • 暗黙知 f:id:yanom20:20181114141658p:plain
          • 事実
            • 手順、歴史/根拠
            • 知っている人は書いてなくても困らないから
          • 関係
            • 関係は問題に対する視点。事実だけを書き並べても見えてこない
          • 原則
            • 最初から全ての例外を書き表すことは難しい。
            • 全て書き表すことは自分との対話となりめんどくさい
  • 暗黙知形式知へするためには

    • 事実
      • 5W1Hで書き表す
    • 関係
      • UMLなど図を使う
    • 原則
      • はじめから全てを書き表わそうとせず、ゆるくはじめる
        • 変更されやすいところから書き出す