テクニカルライティングの基本テクニカルライティングの基本を学べます。サイボウズの新入社員向け研修資料です。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 Twitter：https://twitter.com/naoh_nak 2023年度のアップデート版もあります：https://speakerdeck.com/naohiro_nakata/technicalwriting2023
ドキュメント作成時のあるあるアンチパターン20 - Qiita
業務でドキュメントを作成するケースは多々ある 例：仕様書・設計書・提案書・メール・障害票．．． ここでは各ドキュメント共通してありがちなアンチパターンをまとめてみました。 1. 表記がバイト表示・マイクロ秒表示 プログラムが出した数値をありのままに表示するパターン ファイルサイズが100MB, 1GBあろうと、バイト表示にする 桁数が多い数値に、桁区切り（,）を入れない 時間を何でもマイクロ秒・ミリ秒にする（1/100万秒までの精度が必要？体感で分かる？） 桁数が多い＝精度が高い＝良い文書、ではなく、見る人が必要とする精度に切り上げることが重要（売上で１円単位まで出すことが無いのと同様） 悪い例 No ファイル名 ファイルサイズ(byte) 処理時間(秒)
社内ライターさん向けライティングマニュアルを公開します。 - アフィリエイト戦記
どもです、水野です。 社内にライターさんを抱えてから、１年と数ヶ月が経ち、社内ライターさん向けのライティングマニュアルが出来上がってきたので公開します。 また、2015年の6月頃に下記の外注ライターさん向けライティングマニュアルを公開しているので見比べてもらうと外注・内勤の違いが見えて面白いかもしれません。 社内向けマニュアルは2015年の春頃に作り始めましたが、100回以上のバージョンアップをしています。そして下記マニュアルを元にライター初心者の方が 看護師転職ほっとの記事を書きました。 ※社内向けマニュアルをほぼ100％コピペして貼り付けた形なので、伝わりにくい部分もあるかもしれません＞＜その時には気軽にTwitterでもコメントでも質問してもらえると助かります。 1.(記事作成の大前提1）内容は狭く深く 記事の内容は広く浅くではなく、狭く深く執筆してください。1つの項目に対して深く内
記事を書くのに時間がかかっている人へ【伝わる文章を書く技術】 - すばこでゆるライフ
2016 - 09 - 16 記事を書くのに時間がかかっている人へ【伝わる文章を書く技術】 インドアライフ 書籍 Twitter Google Pocket 初めて読みにきてくれた方に読んでもらいたい記事、10選。 伝わる文章を書く技術を読みました。 この本を読んだ目的 「伝わる文章を書きたい！」 この本を書いた人 ライフハッカー日本版で書評を書いている、印南敦史氏です。 印南氏は、週に5日書評記事を書いています。 圧倒的に本を読んで、圧倒的に書いています。 そんな人なので、本の読み方、時間の使い方についても大変参考になりました。 この本を読んだきっかけは、「伝わる文章を書きたい！」ですが、結果的に記事を書くのが早くなりました。 なのでもし記事を書くのに時間がかかることで悩んでいる方がいらっしゃいましたら、ぜひこの記事を最後まで読んでみてください。 1 ．読書術•時間術 本とは、クールにつ
WEBライターが教える「読みやすい文章」を書くためのライティングのコツ | ayan's style
ayan's style > サイトコンテンツ作成 > WEBライターが教える「読みやすい文章」を書くためのライティングのコツ 私はブロガー13年目、最近はWEBライター／旅ライターとしての仕事もしています。 先日、「視点の違いで作り出せるものは変わる！ 新たな視点を獲得する方法」という記事を書きました。読んでいただけるとわかるのですが、書籍のレビューを通常とはちょっと違う切り口で書いた文章となります。 通常は書籍のレビューというと、「○○という本を読みました。その本は…」と、まず本を最初に持ってくると思うのですが、今回はすでにネット上に同じ書籍のレビューがたくさん公開されている状態だったため、最初に本のことを書かず、文章の後半で自然な形に本の内容に触れられる構成を意識しました。 この記事を公開した後、その文章の書き方について、まわりのブロガーさんから以下のようなお言葉をいただきました。
つい文章に入れてしまいがちな「いらない語」5選
そういう「いらない語」は、意識して減らしたほうがいいでしょう。今日は、自分のブログを読み直して「これはいらなかったなぁ」と思う語を、理由と共に挙げていきます。 追記 ちなみにこれらの語は絶対使ってはいけないのではなくて、癖のようになり乱用しがちな言葉、という意味で書いています。 そういう意味で、タイトルも「いらない語」ではなく「多用しがちな語」くらいのほうが正しい気がしますが、1度このタイトルで公開していますので、変えないでおこうと思います。 「いらない語」がもっとも悪文章を書く上で、1番大切なことは「大事なことを書くこと」よりも、「いらない語を書かないこと」です。読んでもらえなくなってしまいますから。 わたしの過去の記事を読み返して「これはいらなかったな」と反省した言い回しや言葉を5つご紹介します。 今後は意識して減らしていきたい「いらない語」を5つご紹介します。 1. ～と思うたとえば
ブログを書き続けること - mizchi's blog
昔から気をつけてることなのだけど、ある程度、ブログ、とくに技術テーマ以外の記事を書く頻度はコントロールしよう、と思っていた。具体的には、1ヶ月の間に2, 3回ホッテントリなどに入ることは問題ないが、2, 3ヶ月連続で耳目を引き続けるのは、避けた方がいいのではないか。とくに落ち着いて暮らしたいなら。 中長期的にあまりに注目を引き過ぎると、勝手に記事間の文脈を悪意を持って補完されたり、固定のウォッチ対象にされてしまったりすることがある。粘着なアンチは聞く耳を持たないので無視するに限るが、人間何に反感を持つかわからないもので、自分がコントロール出来ない要素をたくさん抱えると、書くことそのものが億劫になっていく。日常生活にも影響が出る。少なくとも僕は、自分が書いたものが自分のコントロール下から外れていないか、怖くなってエゴサーチばっかりしてしまう。 「悪意を持ったコメント」に対抗する方法は難しく、
わかりやすさの技術 - やしお
社内向けの教育資料を、ど素人でもわかるようにと思いながら作っていて、じゃあ「わかりやすい」って何だろうって考えてた。今まで読んできたいろんなわかりやすかった本とそうでない本を思い浮かべながら、一般的にここを注意すればわかりやすさを確保できるだろうっていうポイントを一旦まとめておこうと思った。そうしてまとめてみると、本に限らず人に何かを伝えること一般に適用される話だなと思った。 読む側の負担を減らす わからない＝理解をはばむ障害物がある。この障害物を取り除く／回避する作業が「わかる」ために必要になる。その作業を、作者ではなく読者が負担するとき「わかりにくい」本になる。 日本社会だと情報の受け手の側がこの「わかる」ための作業を負うことでコミュニケーションを成立させる傾向にある。空気を読むというようなことだ。そのため発信者側が事前に手を尽くしてわかりやすく発信するというのが苦手で、相手が汲み取っ
「ダメな文章」が「伝わる文章」に激変する３つの基本！ - リクナビNEXTジャーナル
■美しい日本語やカッコいい表現はいらない 「おいおい、伝わるように文章を書いてくれよ」 「ちょっと、これ……意味が分からないんだけど？」 そんな言葉を上司や同僚から言われたことはありませんか？ 仕事で使う文章に求められるのは、「伝える」ことではなく（！）、相手に「伝わる」ことです。せっかく有益な情報をもっていても、せっかくいい仕事をしても、せっかく伝えたい想いがあっても、文章の内容が相手に伝わらなければ意味がありません。美しい日本語やカッコいい表現は必要ありません。大事なのは相手に確実に伝わることです。 残念ながら、学生のときに学んでいそうで、実は学んでいないのが、伝わる文章を書く技術です。今回は「ダメな文章」が「伝わる文章」に変わる３つのポイントをお伝えします。
【永久保存】文章力が向上する192の法則、これが文章の書き方だ！ - ホビヲログ
うまい文章が書きたい。書き方を調べると様々な法則があるようだ。ポイント、ルール、問題点、コツ、ヒント、基本、原則などをまとめてみた。 １．文章を書くのが苦手な人もわかりやすい文章を書ける10のポイント 文章を書くのが苦手な人もわかりやすい文章を書ける10のポイント | 株式会社LIG 主語と述語は正しい関係か 助詞の使い方は適切か 長すぎず、短すぎず 読み手の視点に立っているか それっぽいことを適当に書かない 言葉が足りているか 誤字脱字や表記揺れのない、正しい言葉づかいを コンテクストがあるか 戦略があるか 声に出して読んだとして、違和感がないか ２．読みにくい文章にありがちな、7つの問題点 読みにくい文章にありがちな、７つの問題点 - エディターズダイアリー | ジセダイ 省略してはいけないものを省略している 主述転倒がやたらに多い 誤字脱字や表記揺れが多い 繰り返しが多い 似た表現が
図解でわかる『日本語の作文技術』の導入部分 - 晴耕雨読
2016 - 05 - 11 図解でわかる『日本語の作文技術』の導入部分 人文・思想 言語学 図解 スキル向上 シェアする Bookmark! Facebook Twitter Google+ Pocket 「目的はただひとつ、読む側にとってわかりやすい文章をかくこと、これだけである」 修飾の順序、句読点のうちかた、助詞のつかい方など、ちゃんとした日本語を書くためには技術がいる。発売以来読み継がれてきた文章術のロングセラー。 【新版】日本語の作文技術 (朝日文庫) 作者: 本多勝一 出版社/メーカー: 朝日新聞出版 発売日: 2015/12/07 メディア: 文庫 この商品を含むブログ (1件) を見る スポンサーリンク 1. 修飾する言葉と修飾される言葉を直結させる わかりにくい文章の実例を検討してみると、最も目につくのは、修飾する言葉とされる言葉とのつながりが明白でない 場合である。原
文章を構築する３つのプロセス『大人のための書く全技術』 - 読書で本から学ぶブログ【書評・感想】
書くこと。 苦手な人は多いのではないでしょうか。 こちらの『大人のための書く全技術』を読みました。 大人のための書く全技術 作者: 齋藤孝 出版社/メーカー: KADOKAWA 発売日: 2016/03/30 メディア: 単行本 この商品を含むブログ (1件) を見る 目次 第1章 社会人こそ「書く力」が必要な理由 第2章 書き方を変えると生き方が変わる!――「書く力」を鍛える基本練習 第3章 仕事の成否は文章力で決まる!――ビジネス文書の全技術 第4章 文章の達人になる――ワンランク上の書く技術 第5章 「読む・書く・話す」の達人になる――言葉を磨く最後の全技術 終 章 私の「書く力」を鍛えた四〇冊 優れたビジネス文書は、強固な人間関係を作っていく ビジネス文書を書く力を身につける上でまず第一に重要なことは、「文章は人間関係をつくるものだ」ということを認識することです。 当然ながら、関係
【文章を書くのが苦手な人向け】「伝わる」「揺さぶる」文章の書き方が学べます！ - 四十路の選択
今回のオススメ本は、『伝わる・揺さぶる！文章を書く』です。 本書は、文章を書くのが苦手な方へオススメです。 著者が提案する「文章の7つの要件」について分かりやすく説明されています。 「伝わる」「揺さぶる」文章の書き方が学べます。 伝わる文章書けていますか？ おっさんは、書けていません。 それは、「文章の7つの要件」をきちんと考えていなかったからです。 これからは、この要件を考えてから文章を書くようにします。 著者が言う「文章の7つの要件」とは以下になります。 1)意見－あなたが一番言いたいことは？ 2)望む結果―だれがどうなることを目指すのか？ 3)論点―あなたの問題意識はどこに向かっているか？ 4)読み手―読み手はどんな人か？ 5)自分の立場―相手から見たとき、自分はどんな立場にいるか？ 6)論拠―相手が納得する根拠があるか？ 7)根本思想―あなたの根本になる想いは何か？ 著者について
『文章は接続詞で決まる』論文でも日常会話でも使える“接続詞”の要点 - ぐるりみち。
一口に「文章力」と言っても、その切り口はさまざまだ。基礎となる文法に始まり、構成力や論理性、語彙力や個々人の文体など、 “文章を書く力” はいくつもの視点から考えることができる。 文章それ自体が多彩な要素を持っているのはもちろんのこと、それが新聞であるか論文であるか、あるいはブログであるかといった「媒体」の違いによっても、必要となる “力” は変わってくる。さらには、対象となる「読者層」なども考慮されて然るべきでしょう。 文章は接続詞で決まる (光文社新書) posted with ヨメレバ 石黒圭 光文社 2008-09-17 Amazon Kindle 楽天ブックス さて、そういった「文章」を構成する一要素として、今回は「接続詞」に焦点を当てた本書『文章は接続詞で決まる』を読みました。筆者は、言語学者の石黒圭さん。 ぶっちゃけ、自分にとっては国語の授業で習って以来まったく深く考えること
文章を書けない人は「文章」を書こうとしていませんか？『書いて生きていくプロ文章論』 - 読書で本から学ぶブログ【書評・感想】
プロのライター。 文章を書いて、お金をもらう。 そういう仕事をしている人もいますよね。 今日は、こちらの『書いて生きていくプロ文章論』を読みました。 書いて生きていく プロ文章論 作者: 上阪 徹 出版社/メーカー: ミシマ社 発売日: 2010/11/26 メディア: 単行本 購入: 3人 クリック: 26回 この商品を含むブログ (15件) を見る プロとしての、文章論。 この本の著者、上阪徹氏が考える文章を書く上での心得について書かれています。 目次 はじめに 第1章 その文章は誰が読む？ 第２章 伝わる文章はここが違う 第３章 プロ文章家の心得 第４章 「話す」よりも「聞く」のが大事 第５章 プロの取材はこう行う 第６章 「書く仕事」のキャリア作り 第７章 「職業文章家」として生きる コラム1 ライターという職業 コラム２ 雑誌記事を作る コラム３ 書籍を作る おわりに 何を伝えた
ライバルに一歩差をつける！相手に反論させない文章を書く3つのポイント
伝えたい文章が伝わらず、説得力に欠ける文章しか書けないことで、相手を納得させることができない…と考えたことはありませんか？ そのうえ他の人から文章を元に口頭で説明されると妙に納得してしまう状況になり、自分とは何が違うんだろうと考えてしまうことがあるかもしれません。 あの人の文章ってわかりやすいよね で…結局何が言いたいの？ このように、言葉で思いを伝えようとしても、あなたが主張する話の内容に対して、2通りの結末が用意されているということです。 もちろん、言葉だけではなく文章にも当てはまり、説得力の無い文章は共感を得られず、主張した相手に納得されないままスルーされてしまうのがオチでしょう。 では、どのようにすれば説得力のある文章を書くことができ、相手を納得させることができるのか。文章が伝わらないと考えるあなたに、3つのポイントをお話します。 疑問を無くす 歴史上で起こってきた出来事の背景には
うまいと言われる文章７つの条件『言いたいことが伝わる 上手な文章の書き方』 - 読書で本から学ぶブログ【書評・感想】
文章。 伝わらないと感じることはありますよね。 今日は、こちらの『言いたいことが伝わる 上手な文章の書き方』を読みました。 言いたいことが伝わる 上手な文章の書き方 作者: 安藤智子 出版社/メーカー: 秀和システム 発売日: 2015/11/24 メディア: 単行本 この商品を含むブログを見る とてもわかりやすい本でした。 文章の基本的なところから知りたい人が読んでみると良いと思います。 うまいと言われる文章７つの条件 １ 言葉の出し惜しみをしない ２ 論旨をはっきりさせる ３ 矛盾することを書かない ４ あいまいな書き方をしない ５ うろ覚えなら辞書にあたる ６ 「くどい表現」はスッキリさせる ７ 「手垢のついた表現」は避ける うまい文章の７つの条件だそうです。 これらが揃うと良いのでしょうね。 １と２がむずかしそうでした。 要は、読み手にわかりやすく説明するということだと思ったのです
「、」の打ち方ご存知ですか？ だれも教えてくれない作文の技術 - ミニマリスト ひかるの本棚
「作文」 小学生の頃から始まり何度書いたかわかりませんが、ひとつだけ言えることがあります。 それは、誰も文章の書き方を具体的に教えてくれなかったということです。 誰も教えてくれない文章の書き方 （書評です） 小学生の頃、勉強はからっきし出来ませんでしたが作文は嫌いではありませんでした。 国語の時間に「じゃあ作文を書きましょう！」と先生が手の一つでもパンっと叩けば、周りは嫌な顔をする子が多かったですが、僕は別に苦ではなかったです。 ※出来は良くありませんでしたが。 日本語の作文技術 (朝日文庫) 作者: 本多勝一 出版社/メーカー: 朝日新聞出版 発売日: 1982/01/14 メディア: 文庫 購入: 87人 クリック: 580回 この商品を含むブログ (490件) を見る 中学生からの作文技術 (朝日選書) 作者: 本多勝一 出版社/メーカー: 朝日新聞社 発売日: 2004/10/09
日本語文章のスタイルガイドのまとめ - Qiita
JTF日本語標準スタイルガイド（翻訳用） 実務翻訳において和訳時に使用できる日本語表記ガイドラインです。 このルールを適応出来るtextlintプラグインを書いた azu/textlint-plugin-JTF-style JTF日本語標準スタイルガイドのルールセットで文章をチェックできるtextlintプラグイン | Web Scratch 外来語（カタカナ）表記ガイドライン第3版 カタカナの長音や複合語の際の表記についてのガイドライン JIS Z 8301:2011 規格票の様式及び作成方法ではちゃんと決められてない部分についても書かれている Download International Style Guides - Microsoft | Language Portal Microsoftの各言語別の翻訳スタイルガイド(日本語向けもある) 『社会学評論スタイルガイド』 日本の社会学分
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
https://www.ituore.com/entry/writing-speed
