タグ

ブックマーク / qiita.com/takahi-i (2)

  • 文書執筆の指南書で解説されている問題点を RedPen で発見する

    はじめに 稿では技術文書の指南書で解説されている文書の問題点を RedPen で発見する方法について解説します。紹介する文書の問題点は以下の指南書で解説されている内容です(執筆者の敬称略)。 理科系の作文技術(木下 是雄) 数学文章作法(結城 浩) 文章の書き方(山 和彦) 上記の指南書で解説されている問題点の多くはシンプルです。しかし残念ながら、指南書で解説されている文書の問題点はプログラムのコーディング規約ほど広く認知されていません。さらに問題点に注意しながら文書を執筆するのは簡単ではありません。たとえば、textlint を開発されている @azu_reさん は以下のように述べています。 あなたはIMEほど記憶能力が高くないが、IMEはあなたほど賢くない。 なので二つで作った文章には綻びが生じやすい。 それをtextlintやRedPenなどの第三者が見つける。 — azu (@

    文書執筆の指南書で解説されている問題点を RedPen で発見する
  • RedPen のおすすめ設定 - Qiita

    注意 文書は RedPen v1.8 の利用を想定して書かれています。 はじめに RedPen をインストールして同梱されている設定ファイルで文書を検査すると、相当な量のエラーが出現してしまい少々ゲンナリしてしまいます。大量のエラーが出現してしまうのは、個人や執筆グループによって異なることが多い検査も、デフォルトの設定ファイルに追加されているためです。 今まで RedPen の利用方法や設定方法について記事を書いたのですが、具体的な設定をどうするのかについてあまり触れてませんでした。記事は RedPen のおすすめ設定に関するまとめとなっています。また、RedPen が提供する各機能が作られた意図について書かれた記事「文書執筆の指南書で解説されている問題点を RedPen で発見する」があります。稿を読む前に一読しておくとよいでしょう。 はじめの設定(文長まわり) はじめて RedP

    RedPen のおすすめ設定 - Qiita
    vvakame
    vvakame 2015/09/11
    帰ったら試す
  • 1