簡潔で分かりやすい英文を書くためのコツを整理した - Unboundedly
職場で開催されていた「英語が母国語の人たちを対象とした英作文のコース」で学んだことを引き続きまとめます。 前回は英語論文を書く上で、どのような戦略で原稿を書き進めればよいかについて整理しました。 具体的には次の３ステップの順に執筆することで、効率のよいライティングが可能とのことでした。 論文全体の構造・ロジックの流れを決める パラグラフを書く センテンスレベルで文章を洗練させる ステップ１で決めた骨組みにしたがって、ステップ２ではパラグラフライティングのお作法にしたがってとにかく無心で手を動かして文章化していきます。 ここまででドラフト作成はほぼ完了です。 あとは英文を一つ一つ洗練させていくことで、より簡潔で分かりやすい文章を目指していきます。 今回はこの最後のステップ３を掘り下げていきます。 基本的にはコースで紹介されたこちらのテキストに書かれている内容です。 文章としては完結している
「分からない」が「分かる」に変わる情報デザイン｜はのめぐみ
正確な事実を伝えるのは大事ですが、それだけでは相手に伝わりにくいものです。事実を相手が理解できるように「翻訳する」作業が情報デザインです。この note では具体例と翻訳するためのポイントを紹介します。 情報デザインは相手の認知を設計する方法 情報整理の技術であり、文字・図解・映像・対話などの手段を用いて相手の認知を設計します。「相手の認知を設計する」という点で、コミュニケーションの方法とも言えます。 情報デザインは、伝える相手にとって「意味を持つ情報」になることが重要です。情報を届けたい相手が知覚可能な手段を用いて、それがインターフェイスとして機能するように設計します。 相手の認知を構成するプロセスは認識と理解の二つです。 ※ 「知覚」とは、感覚器官を通じて、外界の事物や事象を見分け、とらえる働きのことです。 多くの人は文章やグラフィックのような二次元的なものを「情報」のイメージとして捉
質の高い技術文書を書く方法 - As a Futurist...
大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？ 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体
文字校正・編集のポイント 2020 | DTP Transit
Illustrator、Photoshop、InDesignをはじめとしたDTP関連の情報サイト。2005年にスタート。 2020年のまとめとして、最近の案件でのスタディをまとめておきます。 文字校正・編集の具体的なポイント箇条書き「違う」冗長な表現Acrobatでのチェック表記揺れ強調の意味で使う記号企業での方針違い数字（半角、全角、漢数字、ひらく）丸カッコ前後の句点カタカナ語の語尾の音引き音引きと罫線半角のパーレン（丸カッコ）とその前後のスペース二重引用符読点チェック相対的な日付InDesign関連脚注・後注索引索引制作の前に索引の削除リンクチェックアポストロフィ音声によるチェックテキストエディタを活用しようオススメはJedit ΩJedit Ωの基本的な文字編集機能Jedit Ωの「複数一括置換」機能その他グラフィカルな台割まとめオンライン校正支援ツール 文字校正・編集の具体的なポイ
現代文書の構造 (La structure des documents modernes) - Stellar
文書を記述する際に、構造――ここでは見出しなどを指す――を機械が可読な形で行うことに意味はあるだろうか。 前回の続きといえば続き。 squeuei.hatenablog.com 前提 scrapbox.io 使わない文書構造の宣言に意味があるのか？ 「文字が大きくなって格好いい」以上の意味がない 使わないのにせっせと構造を宣言しているの、マジで意味わからん markdownはとにかくデカイ文字が簡単に書ける事が便利なだけなのでは？ 宣言した文書構造を有意義に使う方法がスクリーンリーダーと索引生成以外に何かあれば教えて欲しい #で<h1>や<h2>になる文書構造化がしたいと言いつつ、実はデカイ文字を書きたいだけ 反論 markdownが万能でも素晴らしい完全無欠のものでもないというのは理解する。 が、しかし、文字が大きいことと、構造上の意味を持つこととは違う。今価値がないからと言って、将来に
部下から「議事録ってなんで作成する必要あるんですか？」と聞かれたので議事録の必要性について図解してみた
ごらり @gorizukai 部下から「議事録ってなんで作成する必要あるんですか？」と聞かれたことがあるので、今後聞かれたときのために議事録についてまとめてみました。議事録って慣れるまでは大変ですけど、文章の書き方が学べたり、社内人脈ができたりするので入社したての頃は特に進んで議事録作成することを勧めたい。 pic.twitter.com/xV0REtbeVD 2020-11-03 20:56:44 gorilla｜モノづくり企業の図解屋 @gori_career 図解でキャリアや資産運用に役立つ知識をお届け｜元ヘッドハンターが製造メーカーで新規事業を立ち上げ｜経営企画｜age32｜元陸上U20日本代表｜3児の父｜図解したものをブログにまとめています｜図解やコーチングの相談はDMから https://t.co/SrwOVhuF5d
LINE社内テクニカルライティング講座第3弾！不要な人に社内文書を読ませないコツ
こんにちは。Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。LINE社内で大評判のテクニカルライティング講座をブログにまとめてみたシリーズも第3弾になりました。（第1弾、第2弾もぜひ読んでください！） 今回の記事では、以下のようにトピックが多く集まったときに「自分が書いたトピックを（その情報が不要な人に）読ませないためのコツ」を説明します。具体的には、順番に気を配ったり、情報の分類を気をつけたり、タイトルを工夫したり、という話をします。 全部読んでもらおうとしていませんか？ おそらくほとんどの人は、ほかの人の文章を読むときに、必要そうな文だけピックアップして読んだり、タイトルだけで内容を判断したつもりになったりすると思います。検索エンジンで検索したときに、表示された内容だけで、文章の内容を推測して読むか読まないか決めますよね。そう
LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた
LINE株式会社は、2023年10月1日にLINEヤフー株式会社になりました。LINEヤフー株式会社の新しいブログはこちらです。 LINEヤフー Tech Blog こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。今日は、私が1文を書くときに気をつけていることや手法についてお話しします。 そして、この書き出しは、6月にmochikoさんが書いた「LINEの社内には「テクニカルライティング」の専門チームがあります」という記事のオマージュになっています。mochikoさんが書いた記事ですごいpvをたたき出したそうなので、人のふんどしで相撲を取ってみようという作戦で始めてみました。 この記事ではLINE社内で私が講師を務めた「LINE社内で大評判のテクニカルライティング講座」に沿って、わかりやすい1文を書くコツを紹介していま
文章のレイアウトで読みやすさを高める技術「読書アシスト」を期間限定で無償公開 | ニュース | DNP 大日本印刷
2020年7月10日 文章のレイアウトで読みやすさを高める技術「読書アシスト」を期間限定で無償公開 7月10日から日本ユニシスと共同で実証実験を実施 大日本印刷株式会社（DNP）は、目線の動きを誘導するようなレイアウトを自動的に行うことで、文章の読みやすさを高める技術「読書アシスト」の研究・開発に2012年より取り組んでいます。DNPは資本提携している日本ユニシス株式会社と共同で、今回、専用サイト上で当技術によって無料の青空文庫の小説を変換後のレイアウトで閲覧できる実証実験を行います。この実験を通じて、読みやすさに関する利用者の声を集め、今後の商品化や機能拡張に活かしていきます。 〇実証実験の日時 ： 2020年7月10日（金）～9月30日（水） 「読書アシスト」によって読みやすく変換したレイアウトイメージ（右） 【「読書アシスト」の主な特徴と表示方式】 「読書アシスト」は、独自の文章表示
ビジネスに役立つ上手な文章の書き方11のコツ | knowledge / baigie
ベイジの五ノ井です。役職はディレクターですが、編集者の経験があることから、コンテンツや文章のクオリティを管理する立場で働いています。6月からは、ベイジの日報の編集長も務めています。 そんな私の第一回目の記事は、文章について。 デジタル化が進む今、文章力は社会人の最重要スキルといって過言ではありません。 今は会話や電話のような音声コミュニケーションの機会がどんどん減り、多くがメールやチャットのようなテキストコミュニケーションに置き換えられています。文章力がある人には、企画書、社内資料、記事、SNSなど、様々な媒体を通じて自分のメッセージを届け、影響力を高めるチャンスが転がってきます。 これほど重要な文章力について、ほとんどの人は高校以降は専門的な教育を受けることもなく、働き始めます。文章に苦手意識を持っている社会人も非常に多いですが、作家やライターではない社会人が覚えるべき文章のセオリーは僅
Technical Writing | Google for Developers
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.
読みやすい文章のために、極力削るべき言葉リスト｜桜川和樹
最近note書く人増えましたね。新年を迎え、新たに始めてみようって人も多いんじゃないでしょうか。 仕事で文章チェックしていて、削ったほうがスマートになる言葉をいくつか書き溜めてきたので、文章デビューする人のために一挙放出しちゃいます。 「私」「僕」などの一人称 あなたが書いてることはわかっているので、入れなくても伝わる流れであれば削ってOKです。 mina最新号の表紙タイトルを見て、僕ははっとした。 ↓ mina最新号の表紙タイトルを見てはっとした。「と思う」「気がする」 日本人の特性なのか、言い切らずに「〜だと思います」を多用する人は多いです。思い切って削っちゃいましょう。 人生において、言葉が余計な瞬間ってある気がします。本当に心揺さぶられたとき、言葉を重ねることほどナンセンスなことはないと思います。 ↓ 人生において、言葉が余計な瞬間ってあります。本当に心揺さぶられたとき、言葉を重ね
文章をうまくする、とはなにか？【相手の想像力をうまく借りる力】｜北野唯我／マガジン
「卒業文集を読んだけど」 と突然、言われた。母からだ。新大阪から40分。兵庫県のベットタウンに、実家はある。2019年から2020年にかけての年末年始は、実家に帰って、とにかく原稿を書き続けていた。 「文章がうまいとはどういうことか？」と思うことがあった。そのきっかけは、先日、コルクの佐渡島さんとYoutubeで対談した際に「北野さんは、相当文章うまいですよ」と突然言っていただけたことにある。 「文章がうまいってなに？」 と僕はそのとき思った。というのも、振り返ってみると、この「文章がうまい」という言葉は、思い返せば、小さい頃から言われてきたが、人生で最も「ピンときていない言葉」の１つだったからだ。これは誇張ではなく、僕はもともと理系出身で、数学と物理、そして美術だけが抜群にできた。一方で、国語は壊滅的にできなかった。その結果、自分は文章が下手だ、と思っていたからだ。 しかし、佐渡島さんは
ドキュメント技術とプログラミング言語の相似について - golden-luckyの日記
よく知られているように、ドキュメントには「構造」があります。 WebページではHTMLとCSSにより構造とスタイルを分離するべきとか、Wordでは書式設定をスタイルとして定義して使うことで構造とスタイルを分離するべきとか、ドキュメントの「べき」論で必ず言及される「構造とスタイルの分離」における「構造」です。 昨日までの話ではPDFにもドキュメント構造というのが出てきました。あれは、この「構造とスタイルの分離」というときの「構造」とは別物なので注意してください。 たぶん、PDFのドキュメント構造には、「ドキュメントを表すデータ構造」くらいの意味合いくらいしかありません。 一方、ドキュメントの話において「構造とスタイルの分離」というときの「構造」は、もうちょっとこうなんていうか、セマンティックな話です。 データをどう構成するかではなく、ドキュメントで表したい意味をどう構成するか、という話。 し
「という」と「こと」を減らすだけで、文章はぐっと読みやすくなる｜Ryo Yoshitake | THE GUILD
と思っている話です。もはやタイトルでぜんぶ言ってしまった。 せっかくなのでもう少し続けます。 2020/05/03追記：第二弾？書きました この本がまだ初稿になる前、共著者のみなさんと執筆真っ最中の頃に何度か打ち合わせがあったのですが、そこで「書籍的な文章を書き慣れてない人って、"という"と"こと/もの"を多用しがちなので、この2つを抑えるだけでも文章がシュッとするんですよ」とお話したら思ったより反応があったので、これは需要があるんじゃないかと感じたのがきっかけです。 ここから先は具体例を交えて解説していきます。 さすがに他人様のテキストを使うのは気が引けるので自分が書いた記事を例に挙げます。……でも自分はこのテクニックを使うようにしているので、該当する記事がなかなかないんですよねぇ……と思ったらあった！ （よりによってこれか……せっかくなので皆さんスタァライトを観ましょう！） 記事中では
簡単に真似できる文章上達術｜ベイジ社内勉強会資料
2019年3月26日に社内で実施した文章力をアップするための勉強会の資料です。プロのライターのようなハイクオリティな文章ではなく、ビジネスパーソンが仕事をする上で最低限機能する上での「上手な文章」を、とても簡単な3つに絞って話をしています。実際の勉強会ではワークもしてもらいました。皆さんもこれを読んで、…
自動要約 無料ツール by ユーザーローカル
要約したい文章を入力し、「自動要約する」のボタンを押してください。10,000文字までの文章を要約することができます。 サンプル： 芥川龍之介 『蜘蛛の糸』
技術文書を書くための７つのルール
技術文書を書くための７つのルール¶ さまざまな面から見て、良いドキュメントを書くことは、良いコードを書くよりも簡単です。多くの開発者はドキュメントを書くのはとても難しいことであると考えていますが、いくつかのシンプルなルールに従うだけで、本当に簡単になります。 ここでお話しするのは、ポエムの本を書くための方法ではなく、プログラムの設計やAPI、コードベースを作り上げる上で、必要となるものを理解するための包括的なテキストを書くための方法になります。 全ての開発者はそのようなテキストを書くことができます。本節ではあらゆる場面で適用できる7つのルールを提供します。 ２つのステップで書く: まずはアイディアにフォーカスし、その後レビューを行ってテキストの形を整えます。 読者のターゲットを明確にする: それを読むのはだれですか？ シンプルなスタイルを使用する: 分かり易くシンプルに保ちます。正しい文法
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
文章要約AI タンテキ
技術文書アンチパターン集
