技術系メーリングリストで質問するときのパターン・ランゲージ

技術系メーリングリストで質問するときのパターン・ランゲージ

01はじめに 02メーリングリスト ―― サポートセンターではなく互助会です 03表題 ―― あいさつではなく用件を書きましょう 04自己紹介 ―― 自分の知識・技能・経験を簡潔に書きましょう 05書き出し ―― 最初に問題の要旨を書きましょう 06肩書き ―― 会社の名前を背負っていることを忘れないように 07実行手順 ―― 手順は箇条書きで書きましょう 08結果の予想 ―― 期待した結果を書きましょう 09実際の結果 ―― 実際に起きたことを書きましょう 10ステップ明記 ―― どこからうまく行かなくなったかを書きましょう 11実際の値 ―― 条件を具体的に書きましょう 12エラーメッセージ ―― 必ずコピー＆ペーストしましょう 13判断理由 ―― そのように考えた理由を書きましょう 14文献の引用 ―― 読者の手間を省くように書きましょう 15ソース ―― 関連する部分を抽出して示しましょう 16スレッド ―― 関連する話題なら「返信」しましょう 17メールの引用 ―― 適切な量だけ引用しましょう 18仕様書 ―― 仕様書にあたって確認しましょう 19環境 ―― 自分の環境をはっきり書きましょう 20過去ログ ―― 投稿前に過去ログを読みましょう 21検索エンジン ―― 投稿前に、自分で検索してみましょう 22著者・作者 ―― 書いた本人に尋ねましょう 23まとめのメール ―― 投稿した本人が要点を簡潔にまとめましょう 24ローカルルール ―― 郷に入れば郷に従え

Chapter 14

文献の引用 ―― 読者の手間を省くように書きましょう

結城浩 / Hiroshi Yuki

2020.10.22に更新