Qiita公式が公開している「良い記事を書くためのガイドライン」というのがあります。
Qiitaに限らず技術系のブログ記事を書く際にはとても参考になる内容で、かつ簡潔にまとまっているのでシェア。
良い記事を書くためのガイドライン - Qiita:Support
ガイドラインの目次
- このガイドラインについて
- 役に立つ記事を書くために
- 意識すると望ましいもの
- 具体的で簡潔なタイトルをつける
- 環境や前提条件を説明する
- 引用元や参考元へのリンクを書く
- 記事を書くうえで気をつけること
- 著作権に気をつける
- ライセンスや秘密保持契約に気をつける
- 利用規約を守る
- 分からないことがあったら
参考になるポイント
例が載っているのがとてもわかりやすい。
- 「Rubyメモ」→「Rubyの定数探索はスコープと継承関係のどちらが優先されるか」
- 「正規表現でハマった」→「RubyとJavaScriptの正規表現では複数行モードの意味が違う」
- 「OpenSSLのバグ」→「CentOS 6.5でOpenSSLのHeartbleedバグにパッチを当てた」
など。
自分も再度読み返して、よい記事を書けるよう精進します。