●最初の読者として純粋な気持ちで読み進める
→ 想定読者層のレベルになりきる。そのレベルでは難しい用語には補足説明を加える。用語辞典やWikipedia、記事などへのリンクも入れることが望ましい。
→ サンプル開発やコードがあるものは、読者と同じ立場になって、コーディング・ビルド・実行してみて、滞りなく実行できることを保証する。ただし環境構築などの面で実施不可能な場合はこの限りではない。
●用号統一の優先順位
- Xxxx+Insider.NET 独自の特殊ルール
- Xxxx+Insider.NET 過去記事で最多の用語で統一
- 『共同通信社 記者ハンドブック 第12版』に従う
過去記事で最も使われている用語を使用する。これを調べるには、検索で調べる(Xxxx+Insider.NET)。本ページ下部の検索窓などを利用してもよい。
●用語辞書へのリンク
対象読者に有益になることを優先してリンク先を決める。推奨は以下。
- Wikipedia日本語版
- @IT上の用語辞典もしくは記事
- MSDNライブラリなどの本家サイト
戻る → 執筆ガイドのトップページ