テクニカルライティングの基本を学べます。サイボウズの新入社員向け研修資料です。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 Twitter:https://twitter.com/naoh_nak 2023年度のアップデート版もあります:https://spe…
![テクニカルライティングの基本](https://cdn-ak-scissors.b.st-hatena.com/image/square/967b048b3d0c08d1d79f4f18783f7647933720e7/height=288;version=1;width=512/https%3A%2F%2Ffiles.speakerdeck.com%2Fpresentations%2Ffaa63b5c68cc450b878e384181e1b7cd%2Fslide_0.jpg%3F21597936)
こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。先日、このLINE Engineering Blogで「LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた」というタイトルで、1文を書くときに気をつけていることや手法について紹介しました。 前回の記事を簡単にまとめると「たくさんの文案を書いて、一番良さそうなものを選択することがとても大切です」という話を多くの例文を使って説明しました。まだ読んでいない方はぜひ読んでみてください。 今回の記事は、第2弾です。次のステップとして「1文では説明が終わらない文章をどのように組み立てていくとわかりやすいか」という話を、以下のような文章を例に説明していきます。 ここでは、このくらいの情報量の文章を「トピック」と呼びます。 第2弾を最後まで読む
ウェブ制作や開発の仕事で文章を扱う機会は多いはず。書き手は不自然に思っていない文章でも、読み手は違和感をもっていることがあります。文章校正テクニックを覚えるだけでおかしな表現は少なくなり、読みやすい文章を書けるようになります。 本記事では、ICS MEDIAで実践している文章校正の一例を紹介します。 レベル1、基本的な校正ルールを使う いろんな場面で使える基本的な文章校正テクニックから紹介します。 テクノロジー系の名詞は正しく記載しているか テクノロジー系の名詞を間違って使うと、「本当に技術に詳しいの?」と読者からの信頼度が下がります。名詞は大文字小文字、スペース有無含めて正確に記述しましょう。 Github → GitHub(Hは大文字) Javascript → JavaScript(Sは大文字) After Effect → After Effects(複数形の「s」を忘れてはいけな
僕は、とある法律事務所で働く弁理士🙈 僕は、毎日、特許明細書と呼ばれる法律文書を作成する仕事をしています。 その過程で、文章力を高めてきました。 そこで、今回は、「読みやすい文章の書き方」についてお話ししたいと思います。 目次です 読みやすい文章を書くために重要なことは2つ 作文技術を身につけることが文章力を上げるために重要 作文技術を向上させるために重要な5つのこと (1) 「主語を明確にすること」 (2)「助詞『は』と助詞『が』の使い分けを理解すること」 (3)「被修飾語に係る複数の修飾語を分かり易く整理すること」 複数の修飾語を整理するコツ (4)「句読点(、)をつける位置を理解すること」 (5)「旧情報⇒新情報の順番で書くこと」 作文技術を向上させるためのおすすめの本 読みやすい文章を書くために重要なことは2つ まず、読みやすい文章を書くために重要なことを2つ挙げます。 それは、
渡辺です。 昨日のエントリーが結構反響大きめだったので、第二弾です。 文章校正をしていてよくあるパターンを幾つか抽出してみました。 ただし、前回紹介しているパターンは除外していますので、あわせて確認ください。 重複を減らす 文章校正の基礎は 重複を減らす ことです。 次の文章を見てみましょう。 AWSを使い慣れている人にとっては簡単な作業ですが、使い慣れていないと戸惑う所も多いところです。 この文章がくどく感じる理由は、「使い慣れている」が重複していることです。 前後関係もありますが「ところ」がなにを指しているのかも曖昧ですね。 後半の「使い慣れている」を削除し、バランスを取るために作業を後ろに移動しました。 さらに、前の文章を受けるため、「これは」を追加します。 これは、AWSを使い慣れている人にとっては簡単ですが、そうでないと戸惑う作業です。 スッキリしました。 しかし、「慣れていると
依存関係 natto が利用できる必要があります。 使い方 Rhymer::Parser.newの引数に文章を渡すと、検査結果が含まれたインスタンスが生成されます。インスタンスのrhymesメソッドを実行すると、韻を踏んでいるフレーズの組み合わせの配列が返されます。 require "rhymer" rhymer = Rhymer::Parser.new("今日はとても良い天気ですね。こんな日は自然に元気になります。") rhymer.rhymes.each do |rhyme| puts [rhyme[0], rhyme[1]].join(" ") end require "rhymer" lyric = <<"LYRIC" 1853年(嘉永6年)、長崎の出島への折衝のみを前提としてきた幕府のこれまでの方針に反して、江戸湾の目と鼻の先である浦賀に黒船で強行上陸したアメリカ合衆国のマシュー
はじめに 僕は最近ちょっと長めのブログエントリとQiita記事を書きました。 blog.jnito.com qiita.com どちらの記事も約1万4000字、400字詰め原稿用紙35枚ぶんぐらいの文量です。 「我ながらこんな長い文章よう書いたわ~」と自分で感心してしまうのですが(自画自賛)、長い文章を書くためにはちょっとしたノウハウがあります。 というわけで、今回のエントリはブログやQiita記事を書くときの僕なりの手順やノウハウをまとめてみます。 文章を書く前にまずアウトラインをまとめる こういう長めの文章を書くときは、僕はまずアウトラインをまとめるようにしています。 具体的にはこんな感じです。 アウトラインといっても特別難しいものではなく、基本的には書こうと思っているコンテンツのざっくりしたメモです。 アウトラインは箇条書き(リスト)にして、親子関係を作っていきます。 文章を書くとき
本日も素人さんの原稿をチェックしているのですが、先日少し書いたように「特にこだわりがなければ開いた(平仮名にする)ほうが読みやすくなる表現」の一覧をザッとまとめてみました。まったく意識していない人が少し気をつけると、かなり変わります。 pic.twitter.com/kP5gq2aFbR — たられば (@tarareba722) May 30, 2015 先ほどの「開いたほうがいい表現」って、たぶん中学校くらいの体育教師が「走るときはアゴを引いたほうがいい」とか「腕は進行方向にまっすぐ振ったほうがいい」というような話なので、自己流で定着した走り方が楽だったり、もっと専門的な走り方が身に付いている人には関係ない話だとは思います。 — たられば (@tarareba722) May 30, 2015
引きつける文章、伝わる文章が作成できる無料ツールを集めました! サイトやブログ、プレスリリースなど、ビジネス上では文章を書く機会がたくさんあります。今日は、ライティングに苦手意識のある方でも、簡単に良い文章を作成することができるツールをご紹介します。すべて無料で、会員登録やインストールも不要です。ぜひ気軽に使ってみてください。 [目次] ■1)誤字脱字、タイプミスを正して読みやすく ■2)やさしい単語を使って伝わりやすく ■3)表現を豊かにして魅力的に ■4)忘れてはいけない最後の微調整 ■5)文章のたたき台を作るのにおすすめ ■1)誤字脱字、タイプミスを正して読みやすく 良い文章の基本は、誤りがないことです。まずは、誤字脱字やタイプミスがないかを確認しましょう。 【1】誤字脱字、変換ミスのエラーをチェックできる 「Enno」 日本語のあからさまなエラー (タイプミス、スペースのエラー、誤
One of the hardest elements is concocting a great lede; ledes being the one chance you have of persuading readers to commit to an article in full. Here are five tips to start well. Writing for the Web is a skill that's easy to learn but difficult to master. One of the hardest elements is concocting a great lede; ledes being the one chance you have of persuading readers to commit to an article in f
この記事では、LINEグループに招待できない・参加できない時の対処法や原因についてお伝えしていきたいと思う。 複数人で連絡を行う際にLINEのグループ機能は非常に役に立つ。学校でも職場でも利用されている事が多く、グループ内通話も出来るので簡単な打ち合わせ程度であれば、LINEでも可能になった。 グループの作り方も非常に簡単。 しかし、なぜか相手に招待が届かない…といったことも度々ある。 では、この招待が届かない時によくある原因について見ていこう。 LINEグループに招待できない時の対処法・原因 基本的に以下の場合は、相手に招待を送っても届かない。 既にLINEを退会している(アカウントを変更している)場合 既に招待を送っている場合 相手にブロックされている場合 もしくは、招待しているけれど参加されない…といった場合は、相手側が参加を拒否している可能性もある。 上記の3点に当てはまらない場合
今日は、Webコンテンツ作りをする人向けに、日本語表現で「こういう表現は使わないようにしたい」ミスを紹介します。 編集者の目で見ると「あちゃー、そういう言葉のミスしちゃうのね、残念」という表現が、企業のWebコンテンツだけでなく、ブログ、ソーシャルメディアの投稿、企画書、プレゼン資料など、いろんなところでみつかります。 意識していないとつい使ってしまいがちな、「あるある日本語のミス」を、いくつか紹介しましょう。 × 「レスポンシブルWebデザイン」 ○ 「レスポンシブWebデザイン」かなり恥ずかしいです。「レスポンシブル(責任をもつ)」のではなく、ブラウザの状況に「レスポンシブに(反応して、応じて)」表示が変わるようにするデザイン手法です。 × 「フューチャーフォン」 ○ 「フィーチャーフォン」これもかなり恥ずかしい。非スマホな高機能ケータイのことであって、「フューチャー(未来)」ではあり
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く