第3回:本音は本音だからこそ言えないものか (2/3)

正直使う?ガイドライン

【楽々デブドックを書こう!】正直使う?ガイドライン

第3回:本音は本音だからこそ言えないものか

著者:シンクイット編集部

公開日:2008/02/25(月)

自社内でガイドラインを設けているか

続いての質問は、この発注者ビューガイドラインのようなガイドラインを自社内でも設けているか、というものだ。まずプロジェクトマネージャのA氏は「設けていると考えているが、ここまで詳細なものはない」と答えてくれた。

さらに「社内でガイドラインを設けておけば便利なように感じるが、実際の案件ごとに対応していけるかは疑問だ。個人的にはガイドラインを用意しておくことよりも、このガイドラインを作ることそのものが1つの事例としてスキルになっていると思う。その意味では、このプロジェクトに参画した方々は、ドキュメント作成についての大きな経験をしたといえるのではないだろうか」と語ってくれた。

プログラマB氏の所属する部署では、事情が異なるという。「ガイドラインは一応用意されている。しかし、さまざまなプロジェクトの共通部分のみに限定されている。しかし作られているガイドラインそのものが長期間更新されていないので、個人個人がカスタマイズしたドキュメントが作成されている状況だ。

もちろんそれらを再構成することで、ガイドラインとして機能させることは可能だと考えているが『統合するための時間的な余裕』そのものがなく、『あれば楽』だと皆が考えているのにも関わらず、それを作る作業そのものが『負担』となっている」

図2:ガイドラインを設けているか
図2:ガイドラインを設けているか

なぜ「ガイドラインがある」といいにくいのか

自社内でガイドラインを設けるにあたって「ガイドラインがあるといいにくい状況がある」と、プロジェクトマネージャのA氏は語る。これは「ガイドライン=前例」ととらえ、これから手がけるプロジェクトに対して前例のまま進めてしまおうとする人の存在と、その危険があるというのだ。

「これは考えすぎかもしれないが、ガイドラインがあることによって、それを利用しようとするのではなく、そのガイドラインが『結果』になるようにプロジェクトの構成を決め、作業を進めてしまう可能性がある。

実際に現場では『どの資料を参考にすればいいですか』という声が聞こえるが、これでは個々のプロジェクトの目的を作業に反映するのが難しくなる」とA氏は言う。

まったく同じではないものの、プログラマB氏もガイドラインを利用した場合の懸念事項として、次のようなものをあげてくれた。

「『ガイドラインに沿って』というと『ありものをちょっと変えただけ』、もしくは『ほかのものと一緒なのか』という印象を持たれるように思う。また、個々のプロジェクトについての細かい部分はガイドライン化しにくく、結局プロジェクトに合わせたものを作るほかない。

結果として、ガイドラインそのものが機能しない。さらに『ありものを変えただけ』という印象を発注者に与えてしまうことはマイナスになるのではないだろうか。ある程度受注案件が決まっている企業、または部署であれば、ガイドラインとして上手く活用できると考えられる」 次のページ



INDEX
第3回:本音は本音だからこそ言えないものか
 解答不可能? 「困っている」のに「困れない」
自社内でガイドラインを設けているか
 「画面編」以外はどうなるのか
【楽々デブドックを書こう!】正直使う?ガイドライン
第1回第1回:開発者ガイドラインとはなんだ?
第2回第2回:知っていてこそのガイドライン
第3回第3回:本音は本音だかこそ言えないものか

人気記事トップ10

人気記事ランキングをもっと見る

企画広告も役立つ情報バッチリ! Sponsored

ClickHouse Cloudが実現した広告運用SaaS「ATOM」のデータ基盤革新、パフォーマンスを向上しながら、運用負荷とコストを削減 11月11日 6:20 AIで開発が加速する時代、品質保証はどう変わる? Tricentisが示すAIエージェント活用の実像 11月9日 6:45 悪用までの猶予が「1分」に迫るフロンティアAI時代に開発と本番を貫く脆弱性管理が必要 10月29日 8:30 欧州CRA対応とSBOM運用。AI生成コードのOSS混入問題の対策とは ――スニペット単位で検出する「FossID」「Insignary Clarity」によるSBOM運用 9月16日 6:40 PostgreSQLからTiDBへ、稼働中SaaSで進める段階的DB移行の実践と再設計への展望 9月7日 6:30 機能安全開発におけるGoogleTestの活用を支援!「Parasoft C/C++test CT」で実現する効率化&AI連携 4月14日 6:30 【CNDW2025】Grafanaが明かす「オブザーバビリティの哲学」ー最小限の労力で実用的なインサイトを得るには 1月23日 6:30 【CNDW2025】プロダクト急増に備える基盤刷新 ーウェルスナビがECSからEKSへの移行で得た知見とは 1月15日 6:30 【CNDW2025】250環境を5人で運用、構築時間は30分に ーKINTOテクノロジーズが語るインフラ基盤組織の作り方 2025年12月18日 6:30 新たな自動化で熱視線! AIエージェントの「推論能力」を支える2つのコンポーネントとは? 2025年11月28日 6:30