「することができる」は有害と考えられる - Qiita
「することができる」とは 技術文書を読んでいると「することができる」「することが可能である」という表現を目にします。実はこの「することができる」という表現は冗長なため有害、つまり多用すべきでないという考えがあります。 気になって「することができる」についてGoogleで検索してみました。結果、「することができる」という表現について書いたブログ記事をいくつか見つけました。以下、発見したブログ記事の一覧です。 読みやすい文章の極意は「修飾語」にあり 読みやすい文章を書くために心がけたい１０のポイント 感性工学的テキスト商品学～書き言葉のマーケティング 列挙したブログ記事の全てで「することができる」を多用しないように警告しています。 「することができる」を自動で検知 私も「することができる」「することが可能である」のような冗長表現をできるだけ利用しないように気をつけています。「することはできる」
わかりやすさの技術 - やしお
社内向けの教育資料を、ど素人でもわかるようにと思いながら作っていて、じゃあ「わかりやすい」って何だろうって考えてた。今まで読んできたいろんなわかりやすかった本とそうでない本を思い浮かべながら、一般的にここを注意すればわかりやすさを確保できるだろうっていうポイントを一旦まとめておこうと思った。そうしてまとめてみると、本に限らず人に何かを伝えること一般に適用される話だなと思った。 読む側の負担を減らす わからない＝理解をはばむ障害物がある。この障害物を取り除く／回避する作業が「わかる」ために必要になる。その作業を、作者ではなく読者が負担するとき「わかりにくい」本になる。 日本社会だと情報の受け手の側がこの「わかる」ための作業を負うことでコミュニケーションを成立させる傾向にある。空気を読むというようなことだ。そのため発信者側が事前に手を尽くしてわかりやすく発信するというのが苦手で、相手が汲み取っ
YAPC::Asia 2015で技術ブログを書くことについて発表しました - ゆううきブログ
YAPC::Asia Tokyo 2015の前夜祭で上記のタイトルで発表しました。 今回が最後のYAPCということで、どのようなテーマで応募するかについてかなり悩みました。 技術的にめぼしい内容はほとんどブログに書いてしまったので、ブログを書くことそのものについて発表してみようと思いました。 内容についても、トークの話の元となる個々の要素についてはほとんど固まっていたものの、どのように構成して取捨選択するかということに時間を使いました。 基本的に難しい話はないので、スライドには極力文字を載せずに口頭の話を聴いていただくという形をとりました。 したがって、スライドだけみても情報量がほとんどなく何の話か全然わからないので、公開はしないでおこうと思います。 トーク内容 トークの内容は前半部分と後半部分に分かれています。 前半は基本的に来ていただいた方々に楽しんでいただくように構成して、トークの主
人に指示をするときの「状況・しくみ・不都合・指示」のパターン：技術屋のためのドキュメント相談所：オルタナティブ・ブログ
専門的な情報を、立場の違う人に「分かるように説明する」のは難しいものです。このブログは「技術屋が説明書や提案書を分かりやすく書く」ために役に立つ情報をお届けします。 こんにちは、ドキュメント・コンサルタントの開米です。今日は、「状況・しくみ・不都合・指示」というパターンについて。 たとえば、「人に指示をする」場面を考えてください。 「食中毒を防ぐために手をよく洗ってください」 「雨が降るかも知れないので傘を持ってきてください」 などなど、ごく簡単な例を挙げましたが、「指示をする」時に役立つ便利なパターンのひとつに「状況・しくみ・不都合・指示」というものがあります。 あるしくみによって、ある不都合が起きることがあるので、状況を限定した上で、それを防ぐためにこうしなさい、という指針を示すわけですが、実際に「人に指示を出す」時にはこの情報構造の一部が省略されて伝わることが多く、いろいろと問題を引
なぜ記事・本を書くのか？ Webメディア／出版の基礎知識
一方のメディア（Webメディアや出版社）は、たとえそれが専門領域であっても、できるだけ多くの読者、つまりマスをターゲットしている。よって基本的に、どの記事、どの書籍でも、利益を確保できる一定基準以上のPV（ページビュー）数や実売部数を獲得できることが目標になっているだろう。あくまでビジネスとしてメディア業を営んでいるので、売り上げにつながらないニッチなものは、大半の場合、扱いにくい（図2）。 筆者が感じる両者の違いとしては、素早く情報発信するなら「ブログ」などの方が便利で、より多くの人に長期間、教科書的に読んでもらいたいのであれば「メディア」の方がうまくいく場合が多いだろう。 メディアの現状を説明する上で、開発者による技術情報発信方法の変化に触れておきたい。ここでは、より読者に身近なブログ系の変遷を基にこれを説明する。 ブログ系の変遷 ブログが最も盛り上がっていたのは2005～2010年ご
ふつうの取材執筆心得
これは「取材と執筆」をする人のためのメモです。 私は、20年少々の間、職業として「取材と執筆」に取り組んできました。今回「その経験をレポーターの皆さん向けにまとめてほしい」という注文をいただきました。 まず「何を書くべきか」を考えてみました。文章作法に関する本は、名著・定番と呼ばれる本があります。レポートのような事実を伝える文章の組み立て方、記し方については、『理科系の作文技術』（木下 是雄）と『「超」文章法』（野口 悠紀雄）の2冊が、語るべきことを網羅していると思います。『小説作法』（スティーヴン・キング）にも、実用的かつ興味深いノウハウが記されています。 しかしながら「取材とそのアウトプット」に関しては、これという本はないようです。そこで今回は、私自身が記者教育の過程で教わったことや、自分の職業経験の中で発見したことの中から、皆さんにお伝えできそうな部分を抜き出して書き記すことにします
POLAR BEAR BLOG: 締切を守る10の手段
Matthew Stibbe という人が、「書くことに集中するには」というタイトルの記事を書いています。彼（ロンドンにある Articulate Marketing というライティングのコンサルティング会社で"Writer-in-chief"をしている人物だそう）が締切り直前になって、書き物を仕上げるために行っている10の手段を挙げたものなのですが、参考になりそうです： ■ How to concentrate on writing (Bad Language) ちなみにどんな内容かというと： メーラーを立ち上げるな：立ち上げたとしても、アラート機能などはオフにすること。 自分を隔離せよ：彼自身は Bose のノイズ除去機能付きヘッドホンをするのだとか。 欲と恥を活用せよ：「この仕事を仕上げれば大金が転がり込む！」「この仕事に失敗したら信頼が失われるだろうな・・・」といった欲・恥の気持ちを
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
プロットの書き方 前編
2008-02-02