エントリーの編集
エントリーの編集は全ユーザーに共通の機能です。
必ずガイドラインを一読の上ご利用ください。
記事へのコメント0件
- 注目コメント
- 新着コメント
このエントリーにコメントしてみましょう。
注目コメント算出アルゴリズムの一部にLINEヤフー株式会社の「建設的コメント順位付けモデルAPI」を使用しています
- バナー広告なし
- ミュート機能あり
- ダークモード搭載
関連記事
みんなで育てる仕様書デザイン - Qiita
この記事は Goodpatch Advent Calendar 2020 の5日目です。 はじめに 開発において、仕様書はとても重要... この記事は Goodpatch Advent Calendar 2020 の5日目です。 はじめに 開発において、仕様書はとても重要な役割を果たします。 私が仕様書を作成するときに考慮している観点を紹介します。 仕様書に求めること 正しい仕様が書かれている 本来の仕様書の目的です。 メンバーの目線を揃え、仕様を知りたいてときに知ることができ、新メンバーや未来の自分が仕様を理解できる必要があります。 属人化しない 誰が見ても正しく内容を理解できる必要があります。 誰でも書ける・読めるようにするため、エンジニアリング言語を使わず、正しい日本語で書くようにします。 エンジニア以外も仕様を書くことで、実装や運用を考慮したデザインを作ることができます。 また、現在の仕様に至るまでの過程がわかるようにしておくと、議論を蒸し返さずに納得感を得られます。 仕様書を開くコストを抑える どれだけ素晴らしい仕様