技術系メーリングリストで質問するときのパターン・ランゲージ
目次 はじめに メーリングリスト —— サポートセンターではなく互助会です 表題 —— あいさつではなく用件を書きましょう 自己紹介 —— 自分の知識・技能・経験を簡潔に書きましょう 書き出し —— 最初に問題の要旨を書きましょう 肩書き —— 会社の名前を背負っていることを忘れないように 実行手順 —— 手順は箇条書きで書きましょう 結果の予想 —— 期待した結果を書きましょう 実際の結果 —— 実際に起きたことを書きましょう ステップ明記 —— どこからうまく行かなくなったかを書きましょう 実際の値 —— 条件を具体的に書きましょう エラーメッセージ —— 必ずコピー＆ペーストしましょう 判断理由 —— そのように考えた理由を書きましょう 文献の引用 —— 読者の手間を省くように書きましょう ソース —— 関連する部分を抽出して示しましょう スレッド —— 関連する話題なら「返信」しま
エンジニアとのやりとりに疲れたので愚痴を書く
「お前はコードを書かないから分からない」と言って説明を放棄するのをやめてくれ。 「わからないだろうけど、それは非効率」と言う割に、なぜ非効率なのか説明しない。 「その実装（作業を）する意味がわからない」と言うので、メリットを説明するが納得しようとしない。意味がわからない理由は言わない。 ただのコード書きとして存在してるならわかるけど、技術的アプローチで問題解決する立場の人にやられると辛い。 「ぶっちゃけ、やりたくないんだろ？」とツッコミをしたら負け、「いいから実装してくれ」と言いたくもない。 ダメなら理由を教えてくれ。できないなら理由を教えてくれ。それだけなんだ。（と、言うと機嫌が悪くなる。どうしてほしいの？）
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
クソエンジニア発言１０連発 by yodatomato
