設計書 excel 脱却

ステムインテグレータ Object Browser事業部 マネージャー 後迫 潤 画像は別ファイルにしないといけないしで悔しいけれどExcelには敵わない・・・, https://gist.github.com/tatesuke/57054a31e193ac835b60, できればローカルに適当な名前で保存してブラウザで開いてみてください。上の画像と同じページが表示されるはずです。, そう。完全に単一のHTMLファイルでmarkdownや画像を使った資料ができるのです。 いろいろなサイトを見てみると、Excelを利用した設計書の記述では賛否あるようです。 特にExcel方眼紙に対するコメントは非常に多かったです。 そして自分の設計書もExcel方眼紙です！ Excel設計書・Excel方眼紙を「悪」としている記事を調べてみると２つの傾向がありました。 1. 力で便利なツールですが、いかんせん使いどころを間違えた資料が多すぎるなと感じています。 例えば開発環境などの導入手順書とかバグの調査報告書とか、どう考えてもExcelに向いてない資料まで頑張ってExcelで作っていたりします。 ステムの開発ドキュメント標準化」では、図2のような機能設計書(基本設計書)のひな型をダウンロードできるようにしていました。このときはExcelに手作業で仕様を書く形式でし … システム開発の際、ビジネスパートナー（SIerなどの外注先）との意思疎通に用いられる設計書。, 筆者の周辺だけの傾向なのかも知れませんが、本来、表計算ソフトであるはずのエクセルを使って、設計書を作るという文化ができている企業が少なくないと感じます。, 市役所の帳票にはExcelで作成されているものがあり、見栄えを整えるためだけに、セル結合や罫線が多用された結果、本来の表計算ソフト（データ収集などの機械的処理）の利点が生かせなくなるという、いわゆる「ネ申エクセル」問題も発生しています。, 本記事では、情報システム開発の現場で発生している「ネ申エクセル」問題に踏み込んだ上で、今後、日本のITエンジニアの目指すべき方向性について提言したいと思います。, テーブル構造定義や要件一覧リストなどの「表」が多く含まれるという性質上、システムの設計書にエクセルが活用され始めたという推移は、容易に想像できます。, システムの設計書をエクセルで作ることによって、以下のような弊害が生じていると筆者は感じています。, エクセルを使うことが非合理的であると（頭では）分かっていようと、多忙なエンジニアが改善業務を優先することは難しく、いつまでたっても断ち切られない「悪習」として根付いていくのでしょう。, 設計書を解釈するのがコンピュータであれば、どれだけ長かろうと、どれだけ複雑なパターン分岐があろうと、記載事項にミスがない限り、システムは欠陥ゼロで完成するでしょう。, 実際には、設計書を手に取って読むのは人間であるため、プログラム完了時の品質は、設計書の良し悪しをダイレクトに反映したものになります（設計書の品質がショボいほど、納品されるプログラムの品質も低下するため、設計書の品質は、システムの品質と強い相関関係があると思います）。, エクセルを使って設計書を作ると、「弊害」でもあげたような問題が発生するため、読み手も書き手も消耗し、本来、品質を担保するために費やされるべきパワーが、おそまつな設計書の解読作業へ分散されてしまう結末が待っています。, 逆の発想をすれば、効率よく情報伝達できる設計書の書き方スタイルを確立すれば、完成するシステムの品質も、うなぎ上りに上昇するでしょう。, このような観点で、設計書とシステムの品質について考えたとき、「ネ申エクセル」ってやっぱり是正されるべき問題だということになるのです。, 本記事を締めくくる前に、もう少し深堀して、本来あるべき設計書の姿について論じておきましょう。, 個人差はあろうと、書く側も、読む側も、ミスを犯す可能性をゼロにすることはできません。, 本記事のテーマからはみ出るため、あまり詳しく論ずることはできませんが、骨子となるアイデアのみ記載します。, ドキュメントの構造には、スタイル（h2, h3, h4, ul, ol）を必ず適用します。, また、一度決めたドキュメントの構造は、プロジェクトが終わるまで一貫して、すべてのファイルに対して適用することが重要です。, こうすることによって、書き手も読み手も、頭の中に「フレームワーク」が完成し、次にどのようなコンテンツを書くか（読むか）について、共通認識が形成でき、コミュニケーションミスが激減します。, 一つあたりのドキュメントに書く内容（のスコープ）を小さくすることも、検討しましょう。, たとえば、従業員マスタ情報のメンテ機能を作成する場合、設計書を以下のように４分割することで、（書き手にとって）記述スコープ、（読み手にとって）読解スコープが限定されることになり、成果物（設計書、ソースファイル）の品質を担保することにも寄与します。, 一つの設計書で記載できるところ、四つもの設計書を作るなんて無駄だと感じるかも知れませんが、いちど騙されたと思ってやってみてください。, いろんなメリットを実感できると思いますし、一つの設計書にあれこれ詰め込むよりも、最終的には時間が短縮できることもあると思います。, 「ネ申エクセル」の話題に始まり、設計書の理想論（構造化・細分化）までお話しました。, 本記事で書いたようなことを実業務で実践するには、エクセルではなく、マークダウンによる設計書作成を念頭に入れるべきだということを最後に付け加えておきます。, エクセルに慣れ親しんだエンジニアであるほど、マークダウンへの移行には抵抗があるかも知れませんが、構造化・細分化を意識してドキュメントを作るためには、マークダウンほど最適なツールはないと思うのです。, ITエンジニア志望の大学生へ ITエンジニア志望の高校生へ SEネタ（特に社内SE）, 人件費の安い東南アジア諸国のソフトウェア開発会社を活用しながら、日英バイリンガルのITエンジニアとして活躍する三十代。, 最近では、Web開発（フロントエンド&バックエンド）における、システムアーキテクト的な仕事ばかりやっています。, 保有資格など： Help us understand the problem. \```, ,

ワゴンr オイル交換 値段, ホームページ ブラウザ ずれる, ヘリコプター パイロット 訓練, 富士サファリパーク ホテル 子連れ, 菅田 将 暉 米津玄師 対談, Pasmo 定期 払い戻し クレジットカード, 独身 ヴェル ファイア, 心臓 血液循環 看護, 倉敷 日帰り バスツアー, ガーベラ 種 冷蔵庫, 北海道 バスツアー 函館, あわ の さり 月9, 看護師 目標管理シート 主任, クラッチミートポイント 調整 ヴィッツ, 中日 山本拓実 高校, 送迎 付き 習い事 大阪, 看護師 性格 特徴, 巨人 阪神 対戦成績 年度別, 焼き鳥 扇屋 ランチ, グラクロ コスチューム 再販, 生活科 学校探検 ワークシート, レバ刺し 通販 食べてみた, フェイタルバレット 難易度 エクストリーム, 就活 6月から 21卒, ドンキホーテ 瑞江 コロナ, フォトショップ 使い方 動画, ワードパッド 文字化け 修復, ジム 見た目 変化, Python デスクトップアプリ 例,