質の高い技術文書を書く方法 - As a Futurist...
大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？ 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体
LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた
LINE株式会社は、2023年10月1日にLINEヤフー株式会社になりました。LINEヤフー株式会社の新しいブログはこちらです。 LINEヤフー Tech Blog こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。今日は、私が1文を書くときに気をつけていることや手法についてお話しします。 そして、この書き出しは、6月にmochikoさんが書いた「LINEの社内には「テクニカルライティング」の専門チームがあります」という記事のオマージュになっています。mochikoさんが書いた記事ですごいpvをたたき出したそうなので、人のふんどしで相撲を取ってみようという作戦で始めてみました。 この記事ではLINE社内で私が講師を務めた「LINE社内で大評判のテクニカルライティング講座」に沿って、わかりやすい1文を書くコツを紹介していま
文章校正など、ブログ記事作成に役立つ無料ツール6選
photo by liqueneコンテンツマーケティングの取り組みなどで、ブログ記事を書いていると大変なのが文章の校正です。 タイプミスや誤字脱字は信頼を失い、記事の価値を下げてしまいます。 しかし、人の手でブログ記事の校正・チェックをするのは、なかなか大変な作業です。 実はWeb上には、かんたんに文章校正ができるサービスをはじめ、ブログ記事の執筆後のチェックに役立つツールが無料で提供されています。 そこで、本日は私自身も使っていて、便利だと実感している文章校正やブログ記事執筆に役立つツールの中から、Web上ですぐに使える無料のツールを厳選してご紹介します。 これらのツールを活用すれば、文章校正にかかる負荷を軽減し、時間を圧倒的に短縮することができます。 日本語のタイポ/変換ミス/誤字脱字エラーをチェック 「Enno」 Ennoサイト 「Enno」は、誤字脱字や変換ミスなどの「日本語のあか
FINDJOB!終了のお知らせ | FINDJOB!
FINDJOB! 終了のお知らせ 2023年9月29日にFINDJOB!を終了いたしました。 これまでFINDJOB!をご利用いただいた企業様、求職者様、様々なご関係者様。 大変長らくFINDJOB!をご愛顧いただき、誠にありがとうございました。 IT/Web系の仕事や求人がまだ広く普及していない頃にFind Job!をリリースしてから 約26年間、多くの方々に支えていただき、運営を続けてまいりました。 転職成功のお声、採用成功のお声など、嬉しい言葉もたくさんいただきました。 またFINDJOB!経由で入社された方が人事担当になり、 FINDJOB!を通じて、新たな人材に出会うことができたなど、 たくさんのご縁をつくることができたのではないかと思っております。 2023年9月29日をもって、FINDJOB!はその歴史の幕を下ろすこととなりましたが、 今後も、IT/Web業界やクリエイティブ
驚くほど違う→あなたの文章を最適化するたった４つのルール
文のレベルで、日本語を明確化する工夫について取り上げた著作には、本多勝一(1982)『日本語の作文技術 (朝日文庫)』（朝日文庫）があるが、酒井聡樹(2007)『これからレポート・卒論を書く若者のために』（共立出版）が、さらなる改良に取り組んでいる。 この記事は、両著作についての私的メモの域を出ない。 なお『これからレポート・卒論を書く若者のために』は、井上真琴『図書館に訊け!』(ちくま新書)とともに、大学新入生のマストアイテム。入学する前に読んでおくと、まるでちがった４年間を過ごせるだろう。 以下では、まず日本語の文がわかりにくくなる４大原因を示し、次に４大原因のそれぞれに対応した４つの最適化ルールを提示する。最後に、それぞれのルールについて適用例を挙げて、ルールの活用法を説明する。 文が分かりにくくなる４大原因 １．一つの文に多くの情報が詰め込まれている ２．情報を与える順番がおかしい
「文章の書き方」は人生の生き方 | quipped
先月、およそ15年ぶりに、辰濃和男さんの「文章の書き方」を読んだ。 ページをめくる度に、「おーこういう内容だったのか」と驚いてばかりいたので、以前読んだ時にはほとんど何も理解していなかったに違いない。意味を把握したという点では、はじめて読んだといった方が正確だ。 辰濃和男さんは、1975年から1988年まで朝日新聞の天声人語を執筆していた方で、朝日新聞随一のエッセイストと評価されている方だ。1「文章の書き方」は、彼の考える良い文章を書くための準備や心がけをまとめた本なのだが、いわゆるハウツー本ではないことは、まえがきを読めばすぐわかる。 ...とくに考えてみたいのは「文は心である」ということです。正確にものごとを見る訓練をおろそかにしている人が、はたして正確な文章を書くことができるでしょうか。大自然と遊ぶたのしさを知らない人が、人の心をとらえる自然の描写をすることができるでしょうか。品性の
文章力とは、この世を生きる力である
これまで読んできた文章術の本の中で、トップクラスに入る良書です。本書を読めば、細かいテクニックは抜きにして「人に読んでもらうに値する文章」を書くためのコツを知ることができます。 誰も教えてくれない人を動かす文章術 本音を言うと、本書は紹介したくなかった。ライバルが増えてしまうから（笑） 凡庸さは恥 文章においては、凡庸さは恥です。結果としての凡庸さはある程度しかたがないとしても、せめて「凡庸さは恥」だということを肝に銘じておきたい。実は、このことを知ってもらうことこそ、私が本書を書くにあたっての、隠されたテーマなのです。 脳天をガツンと叩かれたような感覚でした。私は以前から「万民に受ける記事=誰にも読まれない記事」という持論を持っていたので、勇気をもらえました。 「どっちも大事」みたいな理想論をアップしていたら、まったく見向きもされなかったと思います。「それができれば苦労はしない」的なコメ
ココカラハジマル : 私家版「雑誌原稿書き方＿全111条」
本稿の改訂版をnoteにアップしています。項目別に整理しているので見やすいです。下のリンクで最新版をご覧ください https://note.com/cabanon/n/n379c454aad4f 昨日の【雑誌原稿書き方基礎講座】で使ったKeynoteに書いていたことを改変・再編集してアップします。全111条。僕が個人的に積み重ねてきたノウハウです。ライターだけでなく編集者としての心得も混じっています。仕事をしてきた出版社が違えば、このノウハウも違うものになったでしょう。だからあくまでも私家版です。デザイナーや建築家やアーティストや工学研究者の取材記事執筆を前提にした話であることをご了承ください。 ＊アップデート情報 ・全110条を全111条にしたり、第74条を追加して他を統合したりなど、こそこそ修正しているので、3/5にアップしたものとは少し変わっています（3/8記） ・95条の説明に奥義
文章力のシンプルな鍛え方 | シゴタノ！
By: Guudmorning! – CC BY 2.0 「どうすれば文章力をあげることができますか？」 と、私が誰かに尋ねられたとしたら次の二点をあげます。 読むように書く事 書くように読む事 すでに文章を書いている方には当たり前のことかもしれません。しかし、この基本的なことについて触れられているのをあまり見かけないので、今回はこの二つについて考えてみたいと思います。 読むように書く 本多勝一氏の『日本語の作文技術』という本の中では、文章の書き方として「ダメな」例が二つ挙げられています。 話すように書く 見たとおりに書く アドバイスとして「話すようにかけばいいよ」とか「見たとおりに書けばいいよ」と言われれば、書き手としては楽な気持ちになれるでしょう。それらは日常的に行っていることなので、あたりまえにできると感じます。 しかしながら、実際このアドバイス通りにやって文章を書く事ができるか、と
まとめ：文章を磨きあげるテクニックとチェックのハック12選 : ライフハッカー［日本版］, 仕事も生活も上手くこなすライフハック情報満載のブログ・メディア
たとえどんな秀逸なアイディアが自分の中にあったとしても、それを的確に伝える文章力がないと実現は難しいーーそんなふうに考えたことはありませんか？ 昨日行われたライフハッカーのイベント後の雑談で、出演して頂いたパネリストの御一人である杉山竜太郎（株式会社LoiLo/ 取締役）さんは、お子さんの教育について"フリーな方針だよ（笑）"と前置きしつつも、「書くこと」だけはきっちり教えてあげたいと仰っていました。考えてみれば、別に小説家を志すわけでなくとも、メールやら企画書やら、ビジネスにおいて「書く」局面は、今も昔も満載。その傾向はむしろ拍車がかかりそうですから、もっとも有効な"子育てハック"といえるかもしれません。 文章には好みもありますし、文体は人それぞれのパーソナリティーなだけに、よくある文章講座的なものには疑問符をつけたくなります。特に日本語は、その是非はともかく、けっして断定せず、結論を先
プロから教わる、良い文章を紡ぐ5つの珠玉のテクニック | ライフハッカー・ジャパン
作家であり、文学サークルでも著名な講師であるConstance Hale女史が、ライティングに関するワークショップを行いました。彼女は、プロのライターに文章の磨き方を教えるプロなのです。WIREDマガジンの編集者として長年培ってきた知識や、弁護士、CEO、広報など仕事で文章を書くことを必要とされる人たちと働いてきた経験を元に、ありきたりの文章をイキイキとしたものに蘇らせるテクニックを教えてくれました。 これは、文章を書くことを生業にしている人だけでなく、メールやブログや企画書など、あらゆる文章を書く人にとっても、かなり使えるテクニックだと思います。素人からプロフェッショナルまで必見です。 1. 使い古された言葉ではなく"自分の言葉で"書く 私たちは本当に豊かな言葉を持っているのです。それをぜひ使ってください！ 同僚に宛てて書いていても、まったく見知らぬ人に向けて書いていても、いつでも一番ふ
シゴタノ！ — わかりやすい文章を書く上で最低限おさえておきたい読点の二大原則
By: Alex Ziv – CC BY 2.0 「わかりやすい」と言われるような文章を書きたいものです。 とはいえ、単に「わかりやすい文章」というだけでは具体的に何をどう改善すればいいのかがイマイチ「わかりにくい」。 そこで、今回は読点（テン）の打ち方に絞って「わかりやすい文章」に一歩、近づくことにします。参考図書は、現代国語や小論文が苦手だった学生時代の僕に文章を書くことの楽しさと深遠さを教えてくれた以下の一冊。 「血まみれ」になったのはどっち？ 、（テン）や。（マル）や「（カギ）のような符号は、わかりやすい文章を書く上でたいへん重要な役割を占めている。とくにこの場合、論理的に正確な文章という意味でのわかりやすさと深い関係をもつ。（p.74) ということで、テンの役割の重要性を示すために挙げられているのが次の例。 渡辺刑事は血まみれになって逃げ出した賊を追いかけた。 渡辺刑事は、血まみ
ブログ更新を今より楽にするための30のヒント
このブログを書きはじめ、ほぼ毎日更新してはや3年と3ヶ月が経ちました。その中で飽きてしまいそうなので方向性を変えてみたり、サーバーで苦労してみたりといろいろな経験をしてきました。 たいしたお金になるわけでもないのに、何故継続的に更新することが出来ているのか。周囲の疑問であり、自分の疑問でもありますｗ そんなわけで、自分の振り返りも兼ねて参考になりそうなTipsがあったのでご紹介します。 組織のマインドマップツールをマインドマイスターにすべき理由 伸びてる産業、会社、事業を紹介しまくるStrainerのニュースレターに登録!! ブログの更新を有意義なものにする30のTips原文の超訳ですが、個人的にズレを感じたものは私の考えに置き換えています。 1. 記事のアイデアだしは紙とペンでPCに向かっていても限界がある。企画書なんかを作っていても同じですよね。2. 毎週アイデアだしの時間を必ず作る「
コピーとカリスマブロガーに学ぼう！ 魅力的なタイトルの作り方 - はてなニュース
ネット上で文章を書く機会が増えています。せっかく書いたものは多くの人に読んでもらいたいですよね。そのためには内容が大事なのはもちろんのこと、読み手が最初に目にする「タイトル」も重要。読み手を魅き付けるタイトルを作るために、「キャッチコピー」と「カリスマブロガー」に学んでみましょう。 キャッチコピーに学ぶ キャッチコピーとは、人の注意を引く言葉。キャッチコピーの作り方を学ぶのは、タイトルの付け方を知るのに有効です。 クリックさせるキャッチコピーの作り方 - livedoor ディレクターブログ このエントリーでは「伝えたい『特徴』と『相手』をリストアップして組み合わせる」というやり方が紹介されています。3つの小技として、「相手に呼びかける」「数字を使う」「カタカナの繰り返し言葉を入れる」というのも。キャッチコピーを作るには「誰に何を伝えるか」をはっきりさせることが大事です。タイトルを付ける際
読まれる記事を書くために、文章技術よりもはるかに有効なこと - 分裂勘違い君劇場 by ふろむだ
ブログ記事をより多くの方に読んでいただくために、 小手先の文章テクニックや 場当たり的なアクセス稼ぎテクニックなどよりも はるかに効果のあること があると思います。 それは、経営戦略の基本中の基本である、需給バランスに徹底的にこだわることです。 すなわち、需要があるのに供給が不足している記事を書くのです。 本来、「需要があるのに供給が不足している」というのは異常な状態です。 なぜなら、みんなが読みたがっているのに、誰も書いていない記事を書けば、たくさんの読者を獲得できるのは明らかだから、そういう記事は瞬く間にたくさんのブロガーに書かれ、需給はすぐにバランスしてしまうはずだから、 そんな状態は、本来アリエナイはずだからです。 したがって、「需要があるのに供給が不足している」という異常な状態は、 なにか「供給を阻害している要因」がある場合にしか生じません。 なので、取るべき戦略は、 記事の供給
人を惹きつけ人を動かす文章を書く方法 初心者にもわかるコピーライター養成講座 ～言葉で世の中を動かそう - プログラマーkkの勉強/成長ブログ@ライブレボリューション(モバイル広告�
先日、宣伝会議のコピーライター養成講座の特別体験講座を受けてきた。 そのまとめ。 目次 言葉で世の中を動かそう コピーライターへの道 課題 解説 宣伝会議のコピーライター養成講座の宣伝 この講座で得られること コピーライターが求められている理由 コピーライターにはどうすればなれるか・・・その決心と、努力 キョロキョロしよう・・・観る フムフムする・・・聞く ワイワイする・・・話す ムチャクチャする・・・熱中 ウンウンする・・・書く コピーライターのためのコラム 感想 参考書籍 最近書いたまとめ記事 言葉で世の中を動かそう コピーライターへの道 講師は、理論派コピーライターの谷山雅計氏。 まず最初に課題が出された。 課題 『古本屋を若者にもっと利用してもらうためにキャッチフレーズを書いてください』 15分で３つ書くように言われた。 全員分を回収し、30分後谷山さんが戻ってきた。 解説 なぜこ
5分で人を育てる技術 (25)“文書が上手いと言わせる”5つのテクニック(中篇)：芦屋広太一つ...
・先方より，当方が提示した処理画面の操作性が問題なので，見直してほしいとの要望があった。 ・上記については，当方にて検討することで了承いただいた。 ・また，先方から，社内の情報提供に使いたいので，弊社が提供するシステムの機能と画面イメージをメールで送ってほしいとの要望があった。 ・上記については，後日メールする旨返事をした。 ・東氏より，当方のシステムを使ってみたが，非常に分かりやすいとの感想があった。弊社のシステムは特に問題ないのではないかと思われる。 ・戸塚氏からは，上司に説明したところ，テストについてもよろしくお願いしたいとの指示があったとの話があった。 ・これに対し，当方からは，一緒に相談しましょうと回答した。 ・次回の打ち合わせは来週の水曜日くらいとの話になったが，その日は東氏の都合が悪いかも知れないとの話になり，結局，その場では決められなかったため，後日調整しましょうという話に
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
亚美am8客户端|官网首页
ほんのすこし書き方に注意すれば、あなたのドキュメントはさらに分かりやすくなる！