設計書に残すべきは項目ではなく判断である – 粒度、理由、実体をつなぐ文書設計 作者: si62512548投稿日: 2026年6月28日カテゴリー: 設計・運用タグ: ADR, Docs as Code, HLD, LLD, アーキテクチャ, 技術ドキュメント, 文書設計, 構造化, 設計書, 運用設計設計書に残すべきは項目ではなく判断である – 粒度、理由、実体をつなぐ文書設計 へのコメントはまだありません 技術文書と設計の関連記事 「ルータ」と「ルーター」の違いから考える、技術ドキュメントの品質表記統一を文書設計の一部として扱った記事です。 AI を中途半端にしか使えない理由 – プロンプト術より構造化が重要情 […]
基本設計は机上だけで完結するのか – 検証環境と不確実性で考える 作者: si62512548投稿日: 2026年6月19日カテゴリー: 設計・運用タグ: PoC, アーキテクチャ, 不確実性, 基本設計, 技術検証, 検証環境, 設計, 設計書, 責任分界, 運用設計基本設計は机上だけで完結するのか – 検証環境と不確実性で考える へのコメントはまだありません 基本設計は机上資料を作る工程ではなく、方式判断を確定する工程です。検証環境が必要かどうかは工程名ではなく、設計対象に含まれる不確実性、実装差分、相互作用、性能・運用制約で判断します。
「ルータ」と「ルーター」はどっちを使うべきか – 技術文書の表記統一を考える 作者: si62512548投稿日: 2020年10月31日カテゴリー: 設計・運用タグ: エンジニアリング, ルーター, 技術ドキュメント, 技術文書, 文書品質, 用語集, 表記統一, 設計書「ルータ」と「ルーター」はどっちを使うべきか – 技術文書の表記統一を考える へのコメントはまだありません 「ルータ」と「ルーター」のどっちを使うべきかを、長音省略の背景、現代の技術文書での読みやすさ、既存資料や正式名称との整合性から判断します。
