Send feedback Stay organized with collections Save and categorize content based on your preferences. Every engineer is also a writer. This collection of courses and learning resources aims to improve your technical documentation. Learn how to plan and author technical documents. You can also learn about the role of technical writers at Google.
薬でないものを薬であるかのように誤認させ、宣伝・販売を行うことは薬事法で禁じられている。例えば健康サプリメントを「10kg確実に痩せるサプリメント！」「背が伸びる栄養ドリンク！」のように効果効能を掲げて売るのはアウト。薬事法に抵触し、場合によっては逮捕される。 「背が伸びる」サプリ販売で社長逮捕――捜査員のネットパトロールで摘発 - 通販新聞 ※追記・古い記事のため、リンク先のページが消えてしまった。内容については見出しからお察しの通り……。 上のニュース記事のとおり、冗談抜きでお縄となる。 さて「身長が伸びるサプリメントです！」と効果を謳っての販売はできないわけだが、世の中には「身長に悩みを持つ人」をターゲットとしたサプリメントが多数出回っている。 これらのサプリメントはいかにして、薬事法に抵触する「身長が伸びる！」などの表現を使わずに、「身長を伸ばしたい！」と考えるターゲット層に訴求し
うまい文章が書きたい。書き方を調べると様々な法則があるようだ。ポイント、ルール、問題点、コツ、ヒント、基本、原則などをまとめてみた。 １．文章を書くのが苦手な人もわかりやすい文章を書ける10のポイント 文章を書くのが苦手な人もわかりやすい文章を書ける10のポイント | 株式会社LIG 主語と述語は正しい関係か 助詞の使い方は適切か 長すぎず、短すぎず 読み手の視点に立っているか それっぽいことを適当に書かない 言葉が足りているか 誤字脱字や表記揺れのない、正しい言葉づかいを コンテクストがあるか 戦略があるか 声に出して読んだとして、違和感がないか ２．読みにくい文章にありがちな、7つの問題点 読みにくい文章にありがちな、７つの問題点 - エディターズダイアリー | ジセダイ 省略してはいけないものを省略している 主述転倒がやたらに多い 誤字脱字や表記揺れが多い 繰り返しが多い 似た表現が
生まれてはじめて書く人のための、小学生向け小説執筆マニュアル（手順書） 読書猿Classic: between / beyond readers はオールインワンの総論だったので、各論をもう少し詳しく説明しろ、という話がありました。 今回は、小説だけでなくマンガでも映画でも共通するストーリーをつくることに焦点をあわせて、なるべくわかりやすく説明してみます。 ストーリーは最低３つのパートからできている 当たり前のことからはじめましょう。 世界最初の創作論（『詩学』）を書いたアリストテレスは、ストーリーは〈はじめ〉〈なか〉〈おわり〉の３つでできているといいました。 というのも、ストーリーは、 ・始まったら必ず終わらなくてはならない→〈はじめ〉から〈おわり〉へ ・しかしいくらか続かなくてはならない→ある程度の長さがある＝〈なか〉が必要 からです。 ストーリーには変化（落差）が必要 ストーリーには
技術書典４に申し込んだけれどもまだキャンセル可能だという時期に、 自分の中の ・自分みたいな素人が技術書書いたってバカにされるだけだという勢力と、 ・技術書典で販売側に立ちたい&もし良いものができなくても今後成長すればいいでしょうって勢力 が闘っていた時に、背中を押してくれた結城先生のツイートを貼ってみます。 もしかしたら、これが次の誰かの脊中を押すかもしれないですしね！ 結城先生のツイート そして思います。文章は、そのつど書かなきゃ駄目ということを。経験を積んでから、十分学んでから、時間ができてから書くのではない。断じて違う。そのつど書く。自分の不十分さをたっぷり自覚した状態で書く。そうでなければ、いつまでたっても書けやしない。— 結城浩 (@hyuki) 2017年11月16日 あなたに強制するわけではなくて、結城の独り言です。十分準備ができて、世の中に出しても恥ずかしくない状態になっ
前回の記事 生まれてはじめて書く人のための、小学生向け小説執筆マニュアル（手順書） 読書猿Classic: between / beyond readers について、物語の作り方はわかった気がするけど、それをいざ小説にしようとすると言葉が出てこない、なんとかしろ、という意見がありました。 実は、小説の文章についても少し書いていたのですが、あまりにも小学生向けでなかったので省きました。参考になる人がいるかもしれないので出してみます。 １ 小説の文章は何からできているか？ 小説は、文章を通して物語を伝えるものです。 小説の文章は、大きく３つに分けられます。 《場面》、《説明》、《描写》です。 （１）説明とは 《説明》は、物語を大づかみに述べる文章です。細かいところを省略して伝えるので《要約》と呼ばれることもあります。 大づかみなので、少しの文章で、長い時間の物語を伝えることができます。 わず
純粋に興味があるんだけど、理系の人は句読点を「,」と「.」にしないと気が済まないの？ それとも横組文書や論文の扱いでそうする習慣がついちゃってるの？
はじめに 「プロを目指す人のためのRuby入門」を出版して以来、本で学んだ内容をブログに載せてくれている方をよく見かけます。 それ自体は著者として大変嬉しいのですが、たまに「ん？これはちょっと・・・」と思うようなブログ記事を見かけるときがあります。 具体的にいうと、本の内容を丸写ししているだけのブログ記事です。 このエントリでは本の丸写しがなぜいけないのか、かわりにどういうブログを書けばいいのか、ということについて書いていきます。 本の内容を丸写ししているブログの例 本の内容を丸写しをしているブログというのは文字通り「丸写し」しているブログです。 具体的なイメージを共有するために「こんな感じ」という例を載せておきます（特定の誰かのブログを意図しているわけではありません）。 タイトル「第2章 2.2.3 文の区切り」 「プロを目指す人のためのRuby入門」を読んでいるので、勉強した内容をメモ
完璧な書き手なんていない。個性を生かせるかは発注者次第オウンドメディアに記事を執筆してもらう書き手をアテンドする際に、優先すべきは「書けることがある人＝コンテンツを持っている人」かどうかです。 文章の上手い下手は、必ずしもいい書き手の条件ではありません。 書き手に読み応えのある記事を書いてもらうために、発注者であるわれわれは何をすべきでしょうか？ それは「書き手が持っている面白いコンテンツを実際に記事に落とし込む」といったアウトプットのお手伝いです。 そのために、オウンドメディアへの寄稿をお願いする際、はてなでは書き手1人1人に対して担当編集がつき、執筆前の打ち合わせから記事完成までをフォローしています。 記事を書いてください！ それも最初から完璧に！！ 上記のような丸投げのオーダーではいい記事はできません。 誰にどんな内容を書いてもらい、成果物をどのようにブラッシュアップするか。それらを
※ほぼ半分を無料公開しているノートです（結城メルマガVol.032より） 今回の「本を書く心がけ」は「手書きノートのスナップショット」をお送りします。 このコーナーは、結城が書籍を書くときにノートに手書きしていたメモをお見せするというものです。メモが何を意味しているか、書籍にはどう反映されたのかを合わせて解説します。執筆の舞台裏をちょっぴりお見せしているといえるかもしれません。 ●「自然な流れ」を作り出すまずは、『暗号技術入門』という書籍を書いていたときのメモです。執筆のためのメモはたくさん書いているのですが、そのうちのとある一ページです。 ◆『暗号技術入門――秘密の国のアリス』（手書きメモ） 上のメモは、日付によると2002年9月24日に書いたものですね。いまからざっと10年くらい前になります。このメモは、「どんな内容の本にしていこうかな」と考えているときに書いていたものです。 この時点
セルフパブリッシングの小説『天使の街』では、プロの校正者さん（校閲さん）に原稿のチェックを依頼しました。セルフ・パブリッシングでは、そこまでやる人はあまりいないと思いますが、作品としても商品としても完成度を高めたい、という想いから、意を決してお願いすることにしました。 今回は、校閲さんにどのような指摘をいただいたか、また事前にどんな準備したか、といったことをご紹介していきます。 ［2017年8月24日追記］見出しは「校正者」としていますが、厳密には「校閲者」が正しい表現です。 校閲さんは小説をどのようにチェックしているか？ 具体的にどんなふうにチェックが入るのか、いくつか例を挙げてみましょう。実際は単純な誤字脱字もご指摘いただいていますが、ここでは作品の書き手として「興味深い」ものを取り上げていきます（ちなみに、黄色い斜めの線は、原稿に反映させた、という自分の目印です）。 よく似た言葉 そ
Mark Rosewater / Tr. YONEMURA "Pao" Kaoru 2014年3月17日 時折、諸君は私に新しい記事の構想を送ってくれる。それに意義があると思ったなら、私はそれを自分の「短いリスト」（カギ括弧を付けた理由は、最近は名前ばかりで短いとはとても言えないからだ）に書き入れる。長年にわたってこの短いリスト上にあった話題が、記事を書くことに関する記事だ。私は2002年からこのMaking Magicの執筆者で、それ以前からもDuelist誌上で多くの記事を書き、コラムを書いてきた。つまり、私には記事を書く経験がいくらかあると言える。 そこで、今回の記事では記事を書く上でのべし・べからずについて語ることにした。執筆に興味のある諸君は、この記事が何か考えるきっかけになれば幸いである。執筆に興味がない諸君も、この記事を通してMaking Magic執筆の裏側を読み取ることが
ブログが書けないときの解決策 8 パターン ブログ初心者から寄せられた悩みを整理すると、「ブログが書けない原因」は 8 つに分かれます。 具体的に見ていきましょう。 01. ブログのテーマが決まらない ブログを始めるきっかけは、大きく次の 2 つに分かれます。 文章を書くのが好きで、みんなに伝えたいメッセージがある 在宅で稼ぎたいなど、目的達成の手段としてブログを選択した 前者の場合、自分の発信したいものがテーマになるので、とくに悩むことはないはず。後者の場合、「書きたいことがない」「何を書けばよいかわからない」という状態になりやすいですね。 ブログの収益化方法は様々で、どれが正解ということはなく、向き不向きもあります。 ブログ初心者におすすめの収益化方法はこちら もしかすると、今のブログだけで必ず成功させたいと思ってあれこれ考えているかもしれません。でも、考えているだけでは先に進めません
今日は文章を書くことを、作業面から助ける提案を。 知っている／やっている人には当たり前すぎる話だが、知ると知らないとでは執筆中の効率の面でも精神衛生の面でも大違いなので書く。 コメントとは何か？ プログラミング言語を用いてコンピュータに何か有用な作業をさせるための指示を書き上げることをプログラミングといい、書かれた指示のかたまりをソースコードという。 ソースコードには、コンピュータが処理を行うときには〈ないもの〉扱いされる（つまり処理されることなく飛ばされる）が、覚え書きとしてコメント（comment）があちこちに挿入されることが多い。 たとえばC++やJavaでは// 以降がコメントと見なされ、PerlやPythonでは、# 以降がコメントと見なされる。 またHTML、Wikiでは、で括られた部分がコメントと見なされ、C、C++、Java、JavaScript、CSSでは、/* と */
書くことはどのようにして学ぶことが、いや鍛えることができるのか？ 書くことによって、というのが唯一正しい答えである。 書くのが苦手な人は書くことをできるかぎり回避する。そうして苦手意識をつのらせる。さらに書くことを回避する。この悪循環を断ち切るには、嫌でも書くしかない。 対して、書くことを楽しむ人は、放っておいても何か書く。書き続ける。 アメリカのミステリー作家ローレンス・ブロックは、Writing Digest誌の連載コラムで、最悪の長編小説を３つ書き上げた男の症例を紹介している。 最初の１篇は、ブロックが最大限の親切心を動員しても一句たりとも良いところがない、それどころか直すことさえ不可能なくらいひどかった。なのに男は次の本を書き始めた。 完成した２つめも最悪といっていい出来だったが、１作目を知る数少ない人たちには大きな改善が感じられた。男はまた次の本を書き始め、書き終えた。 これまた
創作論とか小説の書き方みたいな本について言うと、作家やその周辺の人が書いているせいか、かつてはその困難さを前面に掲げて、結果的に創作行為の神秘性を保守する手合が多かった。 近頃は「誰でも書ける」みたいなのも随分増えたけれど、タイトルだけ付け間違えたようなのが多くて、あいかわらず、もったいぶった文士臭さが抜けてない。 探す場所を間違えたのだと考え、はなっから「創作行為の神秘性」なんて受け付けない人たち向けに書かれたものを探した。つまり子供向けである。 学校の課題になったりするせいか、アメリカのものに、手続きだけに注力した実にアッケラカンとしたのが多かった。 ネットでフリーで手に入るものだと、National Novel Writing Month（通称：NaNoWriMo ※）のYoung Writers Program用ワークブックが、ほぼ同じ手続きを小・中・高校生向けの３種類に書き分けて
「トイ・ストーリー」「モンスターズ・インク」など、次々とヒットストーリーを生み出す3Dアニメーションスタジオのピクサー。あの「超王道」かつ「今まで誰も見たことがない」ストーリー展開はいったいどのようにして作られているのでしょうか。ピクサー流の物語の書き方について、中の人自身がまとめたリストがなかなか面白い内容になっています。 このリストはピクサーのStory Artist、エマ・コーツさんがTwitterでつぶやいたものをまとめたもの。どんなHow-To本にも載っていることですが、うっかり忘れてしまいがちなもの、手癖で進めてしまいそうなことがらをうまくまとめています。 1. 登場人物が成し遂げることよりも、彼らがどう努力してそこに到達したかに注目しましょう。 2. 書き手として楽しいかどうかではなく、観客としてのあなたから見て何が面白いのかが重要だということを頭に入れておかなくてはなりませ
印刷に校正はつきものです。校正は原稿と校正刷りを対照し，誤りを修正指示したり，組版を修正指示したりする作業です。原稿の誤りを訂正する機会でもあります。（推敲する機会ではありません。） 出版社を介さない町の印刷物は著者や発注者が校正してその内容に責任を負うことになります。また，印刷所に出すものでなくても文章の推敲や点検をする機会は多いものです。画面の上でただちに直せることもありますが，紙に一旦プリントして加筆するほうが考えがまとまりやすいこともあります。 校正記号はこれを簡便に正確に記述する便利な記号です。印刷物校正には是非使用してください。 校正記号もJISZ 8208で2007年に改正がありました。より明確に幅の広い指示の仕方が認められています。記入しやすくかつ間違いを誘発しない書き方を考えて見ます。 記入は赤ボールペンで。 鉛筆や黒のボールペンは不適当です。 赤ダマートやクレヨンのよう
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
