はじめに 本稿では技術文書の指南書で解説されている文書の問題点を RedPen で発見する方法について解説します。紹介する文書の問題点は以下の指南書で解説されている内容です(執筆者の敬称略)。 理科系の作文技術(木下 是雄) 数学文章作法(結城 浩) 文章の書き方(山本 和彦) 上記の指南書で解説されている問題点の多くはシンプルです。しかし残念ながら、指南書で解説されている文書の問題点はプログラムのコーディング規約ほど広く認知されていません。さらに問題点に注意しながら文書を執筆するのは簡単ではありません。たとえば、textlint を開発されている @azu_reさん は以下のように述べています。 あなたはIMEほど記憶能力が高くないが、IMEはあなたほど賢くない。 なので二つで作った文章には綻びが生じやすい。 それをtextlintやRedPenなどの第三者が見つける。 — azu (@
![文書執筆の指南書で解説されている問題点を RedPen で発見する](https://cdn-ak-scissors.b.st-hatena.com/image/square/aecdd2309e937f133c066030ee9d7359e82e85da/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fcdn.qiita.com%252Fassets%252Fpublic%252Farticle-ogp-background-412672c5f0600ab9a64263b751f1bc81.png%3Fixlib%3Drb-4.0.0%26w%3D1200%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTk3MiZoPTM3OCZ0eHQ9JUU2JTk2JTg3JUU2JTlCJUI4JUU1JTlGJUI3JUU3JUFEJTg2JUUzJTgxJUFFJUU2JThDJTg3JUU1JThEJTk3JUU2JTlCJUI4JUUzJTgxJUE3JUU4JUE3JUEzJUU4JUFBJUFDJUUzJTgxJTk1JUUzJTgyJThDJUUzJTgxJUE2JUUzJTgxJTg0JUUzJTgyJThCJUU1JTk1JThGJUU5JUExJThDJUU3JTgyJUI5JUUzJTgyJTkyJTIwUmVkUGVuJTIwJUUzJTgxJUE3JUU3JTk5JUJBJUU4JUE2JThCJUUzJTgxJTk5JUUzJTgyJThCJnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnR4dC1jb2xvcj0lMjMyMTIxMjEmdHh0LWZvbnQ9SGlyYWdpbm8lMjBTYW5zJTIwVzYmdHh0LXNpemU9NTYmcz0zYjBjZjkwMzhlYzYzYmNlZDNmYTAyZjFmZDcxOWVjMA%26mark-x%3D142%26mark-y%3D57%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZoPTc2Jnc9NzcwJnR4dD0lNDB0YWthaGktaSZ0eHQtY29sb3I9JTIzMjEyMTIxJnR4dC1mb250PUhpcmFnaW5vJTIwU2FucyUyMFc2JnR4dC1zaXplPTM2JnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnM9NzI0YmFmMzg5OTMwNTRmZjY0MDRiMTFkNjFjZmFmY2Q%26blend-x%3D142%26blend-y%3D486%26blend-mode%3Dnormal%26s%3Dd6d80cecc297d751e05150f0ee0a29c5)