テクニカルライティングの基本 2023年版テクニカルライティングの基本を学べます。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 サイボウズの2023年度 新入社員向け研修の資料です。 Twitter：https://twitter.com/naoh_nak 2022年版（初版）：https://speakerdeck.com/naohiro_nakata/technicalwriting
日記駆動仕事術のススメ | DevelopersIO
「仕事日記を書くといいですよ」という話をする機会があったので、日々の仕事をスムーズにするシンプルな「日記駆動仕事術」について書いてみました。 日記書くといいですよ prismatix事業部の塩谷(@kwappa)です。 他部署の人と1on1する機会があり、その中で「日記書くといいですよ」という話をしました。 そういえば以前からことあるごとに「日記書きましょう」と言い続けていたのですが、ちゃんとコンテンツにしたことはなかったような気がします。 せっかくの機会なので、日記駆動の仕事術とその意義について書いてみます。 日記駆動仕事術 これはぼくの1月の日記（架空）です。Notionを使って、1か月に1ページ使うようにしています。やり方はシンプルなので、手に馴染んだツールで置き換えることも簡単だと思います。 タイムラインとしては、1/31(月)の業務を開始したところ、だと思ってください。 TODO
情報の構造化、してますか？
80年代以降進んだゆとり教育の影響で、「思考力」不足が問われることがあります。これはゆとり教育の問題に限ったことではなく、分かりやすい説明書を書けない要因である「原理原則までさかのぼって考えない」ことにも通ずるのです。 「説明書を書く悩み解決相談室」第14回です！ 教育問題に関する興味深い本を読んだので、その一部を紹介します。『ごまかし勉強（上）学力低下を助長するシステム』という本で、以下は本文中81～84ページの要約です。 80年代後半以降、学習指導要領を改訂する度に学習内容は減ってきた その狙いは「記憶偏重の教育」から「思考力重視の教育」を目指すということだった しかし、学習対象の量を減らせば記憶偏重でなくなるという考え方はあまりにも安易である 実際には、量を減らすと暗記で済んでしまうため「思考力」がそもそも育たなくなる 暗記しきれないほどの量になると、「考えて」基本原則を理解しなけれ
「という」と「こと」を削って文章のもたつきをとる【WEB文章術】 | センスも文才もなくていい 発信力を上げる「WEB文章術」 | mi-mollet（ミモレ） | 明日の私へ、小さな一歩！（1/2）
ミモレで2021年に公開された記事のうち、特に人気があったものをご紹介します。よろしければぜひご一読ください。 無意識に使ってしまいがちで、“文章のもたつき”を生む言葉に「という」と「こと」があります。「という」と「こと」を減らし、言い換えるコツをご紹介します。 「という」はなくても成立することが多い 話し言葉に近い文体で書くブログやWEB記事は、普段の口グセ・言い回しのクセがそのまま文章に出やすいですよね。前回ご紹介した「のですが」同様、「という」も、無意識にクッション言葉として使いがちです。私自身もインタビューの録音をテープ起こしのために聞くと、「〜なんですが」と「〜という」「〜っていう」を多用していることに気づいて反省します。 「〜のですが」や「という」「ということ」など、話し言葉では語気をやわらげるクッション言葉も、文字として連続するとより目障りでまどろっこしい印象に。私はこれを「
Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい - Qiita
はじめに エンジニアにとって、仕様書などの技術的な文章を書くこと（テクニカルライティングとも言います）は避けて通れません。ただ20年来多くのエンジニアの方々と同僚として接してきて思うことは、エンジニアの方の中には「文章を書く」ということに苦手意識がある方が一定数いるということです。 でもこの「テクニカルライティング」のスキルは、才能というよりは一種の「技能」だと思うんです。ある一定の原理原則を理解して実践を繰り返すことで、必ず一定レベルで習得できるものだと著者は信じています。 もしこのテクニカルライティングの原理原則をまだ体系的に学習したことがない、または過去学習したが改めて再学習したいという方に、お勧めのコンテンツを見つけたのでご紹介します。 https://developers.google.com/tech-writing Every engineer is also a write
【英語ライティング】英文添削ならコスパも内容もオンライン英会話がおすすめ
なぜライティングに「会話」なの？と疑問に思うかもしれませんが、英作文のコツが細部までつかめる、とてもおすすめの勉強方法でなんです。 私の場合は中国語でやっていたのですが、2015年ごろ、中国語のオンラインレッスンを毎日25分受けていて、 会話の練習をする日もあれば、私の中文を添削してもらったりと、その時にやりたいことを自由に学んでいました。 その経験から感じたメリットは以下の2つです。 1. 自分のライティングが、相手に伝わったかどうかがわかる。 この段階では、多少の文法ミス、不自然な表現があったとしても、それは気にしなくていいです。 「完璧じゃなかったとしても、自分のライティングが相手に伝わった」という事実で、自信がつきますし、「なるほど、こういう書き方じゃ伝わらないのか」という事実で、改善点が明らかになるからです。 この段階では、こういう事実確認ができれば十分です。 2. 文法ミス、不
論理的な文章の書き方｜文章力を簡単に上げるコツをお話しします。 | 弁理士ブログ｜とある士業の知的な日常
僕は、とある法律事務所で働く弁理士🙈 僕は、毎日、特許明細書と呼ばれる法律文書を作成する仕事をしています。 その過程で、論理的な文章を書くスキルを身につけてきました。 そこで今回は、「論理的な文章の書き方」についてお話しします。 この記事を読むメリット この記事を読むメリットは以下のとおりです。 ・論理的な文章の書き方を理解できる。 ・簡単に論理的な文章を書く方法を理解できる。 ・ブログ、記事、レポート、論文などの文章を書く上で応用できる。 目次です 論理的な文章とは 論理的な文章を書くために重要なこと 論理的な文章を書くための文章の構成方法 具体的な文章の書き方（ほうれい線の予防に関する記事） まとめ 論理的な文章とは まず「論理的な文章」とは何でしょうか。「論理的」というのはその用語自体が漠然とした確定しない用語だと思いますのでここで少し補足します。 ここでいう「論理的」というのは「
物語作者がチラシの裏に書くべき７つの表／もうキャラクター設定表はいらない
Author:くるぶし（読書猿） twitter:@kurubushi_rm カテゴリ別記事一覧 新しい本が出ました。 読書猿『独学大全』ダイヤモンド社 2020/9/29書籍版刊行、電子書籍10/21配信。 ISBN-13 : 978-4478108536 2021/06/02 11刷決定 累計200,000部（紙＋電子） 2022/10/26 １４刷決定 累計260,000部（紙＋電子） 紀伊國屋じんぶん大賞2021 第３位 アンダー29.5人文書大賞2021 新刊部門 第１位 第２の著作です。 2017/11/20刊行、４刷まで来ました。 読書猿 (著) 『問題解決大全』 ISBN:978-4894517806 2017/12/18 電書出ました。 Kindle版・楽天Kobo版・iBooks版 韓国語版 『문제해결 대전』、繁体字版『線性VS環狀思考』も出ています。 こちらは１０刷
若手プログラマー必読！５分で理解できるER図の書き方５ステップ
データベース設計の基本中の基本であるER図。ER図を書きたいけど、「記法が分からない」「どういうステップで書けば良いか分からない」という若手エンジニアも多いのではないでしょうか。 ER図は１０種類近くあり、種類によって記法が異なります。このことが難しいイメージを与えていますが、実はそれほど難しいものではありません。覚えれば良いER図は２種類だけです。 しかも、この記事で解説している基礎知識を押えれば、たった５つのステップで作成することができます。 この記事では、ER図の基礎知識からER図の書き方まで、エンジニアが抑えておくべきER図の全知識をどこよりも分かりやすく解説します。 この記事を読み終えたとき、若手エンジニアもER図を書けるようになっているでしょう。 この記事を参考に最適なデータベース設計を進めて下さい。 １．ER図とは ER図とは、「データベース設計（データモデリング）で使う設計
この10の言葉使いをやめれば文章の説得力が大きく増すのに | jMatsuzaki
この10の言葉使いをやめれば文章の説得力が大きく増すのに 2015年5月8日投稿 2015年7月1日更新 カテゴリ：ブログの書き方 著者: jMatsuzaki photo credit: DSC_0078 via photopin (license) 私の愛しいアップルパイへ インターネットによって誰もがメッセージを発信できるようになったいま、文章力は大きな武器になります。 しかし、いつもの会話の調子で文章を書くとなんともインパクトに欠ける文章になってしまい、悲惨なことになります。 あなたにはこの先ずっといついかなるときであろうともエレガントであって欲しいと強く願っているので、ブログでの執筆を生業にしている私が文章に説得力を持たせるために注意している10のことをご紹介しましょう。 そう難しいことではありません。大切なのはこれから説明する10の言葉づかいを辞めることです。これらのNGワード
理由は「カネがないから」ではなかった！なぜか急増中の若手批評家が飯を食わないワケ
職あれば食あり 人は食べるために働くのか、それとも、働くから食べなければならなくなるのか。そんな素朴な疑問を解き明かすべく、さまざまな職業に従事する人々のランチと人生を追いかける。「職」と「食」の切っても切れない関係を解きほぐす、お仕事紹介ルポ。 バックナンバー一覧 「これは批評家に限らずではありますが」と断った上で、若手批評家の田中二郎さん（仮名、30代）が言う。 「もの書き業は全般に、文のプロレタリアートです」 身も蓋もないが、そういう側面は否めない。にもかかわらず、批評の世界だけはクビを傾げたくなる現象も起きている。 「どういう訳か、なりたい人はたくさんいるんですよ」 養成講座を開くと、たちまち数十人の若者が押し寄せる。マーケット的に言えば、需要はないのに供給ばかりが増えている状況だ。 「なんか、ヘンですね」 「そうなんです」 ネットのおかげで門戸は広がったが… デビューしても批評だ
Aが見た／Aは見ていた
一人称に比べて、三人称の小説は格段に難しいと言われる。視点が管理できないためだ。 筆者は小説執筆歴二年にして二冊の商業出版長篇を上梓するという幸運に恵まれたが、近刊である『オービタル・クラウド』では初めての三人称による記述を試みている。半年間という短い執筆期間で、初めての三人称による小説とその手法を自分のものにできたのは、早川書房の担当編集者I氏の指導のおかげでもある。 ここで忘れないうちに、三人称視点あり小説執筆手法を、再現可能な技術として記しておきたい。第一回目は、主語の助詞からはじめたい。例文は林と北野という人物によるスキット（寸劇）だ。 林はマグカップを持ち上げた。 「もう一杯、もらってもいいかな」 北野はコーヒーサーバーへ手を伸ばしながら苦笑した。 「飲み過ぎじゃないか？」 寝不足はカフェインの摂りすぎのせいだろう、と言いながら湯気の立つ黒色の液体をたっぷりと注ぎ込む。 これが「
物語の作り方／感動させる技術 - デマこい！
誰もが「物語」を求めている。 スティーブ・ジョブズの魅力的なプレゼンには、「三幕構成」という作劇法が応用されていたという。iPhoneが一台あれば映画を作れる時代だ。今ほど「物語」が求められている時代はない。にもかかわらず、物語を作る「技術」の重要性に気づいている人はまれだ。物語作りに必要なのはセンスだけ──と、素朴に信じている人は多い。 物語作りにも、技術がある。 なかでもシド・フィールドが体系化したハリウッド式の「三幕構成」は、汎用性と自由度の高さが魅力だ。脚本製作の現場だけでなく、商談につかうプレゼンや、WEBメディアの記事執筆（※ブログを含む！）、飲み会のときの「滑らない話」にいたるまで、およそ物語性を持つほとんどのものに応用できる。ジャンルを選ばず実用可能な、ほぼ唯一の技術といっていいだろう。 今回は「三幕構成」がどのようなものか、ざっくりと紹介したい。 三幕構成を説明する前に、
わかりやすい文章の10大原則
この記事では、LINEグループに招待できない・参加できない時の対処法や原因についてお伝えしていきたいと思う。 複数人で連絡を行う際にLINEのグループ機能は非常に役に立つ。学校でも職場でも利用されている事が多く、グループ内通話も出来るので簡単な打ち合わせ程度であれば、LINEでも可能になった。 グループの作り方も非常に簡単。 しかし、なぜか相手に招待が届かない…といったことも度々ある。 では、この招待が届かない時によくある原因について見ていこう。 LINEグループに招待できない時の対処法・原因 基本的に以下の場合は、相手に招待を送っても届かない。 既にLINEを退会している(アカウントを変更している)場合 既に招待を送っている場合 相手にブロックされている場合 もしくは、招待しているけれど参加されない…といった場合は、相手側が参加を拒否している可能性もある。 上記の3点に当てはまらない場合
書く力を本当に倍増する、容易くはない５つのトレーニング
書くことはどのようにして学ぶことが、いや鍛えることができるのか？ 書くことによって、というのが唯一正しい答えである。 書くのが苦手な人は書くことをできるかぎり回避する。そうして苦手意識をつのらせる。さらに書くことを回避する。この悪循環を断ち切るには、嫌でも書くしかない。 対して、書くことを楽しむ人は、放っておいても何か書く。書き続ける。 アメリカのミステリー作家ローレンス・ブロックは、Writing Digest誌の連載コラムで、最悪の長編小説を３つ書き上げた男の症例を紹介している。 最初の１篇は、ブロックが最大限の親切心を動員しても一句たりとも良いところがない、それどころか直すことさえ不可能なくらいひどかった。なのに男は次の本を書き始めた。 完成した２つめも最悪といっていい出来だったが、１作目を知る数少ない人たちには大きな改善が感じられた。男はまた次の本を書き始め、書き終えた。 これまた
はてな村 解説 - もちもちてちやう
きのうの図に説明を追加しました。（また、わすれていたものも描き足しました。） どうぞご利用ください。 ･･･
文章を「書ける人」と「書けない人」のちがい - デマこい！
文章を書くという仕事は、ゼロを１にする作業だと思われがちだ。 小説や脚本、ゲームシナリオなどの創造的な文章ならばなおさらだ。しかし実際には、文章を書くというのは１００を１にする作業だ。文章を書けるかどうかは、このことに気づけるかどうかだと思う。作家にせよ、ジャーナリストにせよ、それこそアルファブロガーに至るまで、きちんとした文章を書ける人はみんなこのことに気づいている。 狼と香辛料 (電撃文庫) 作者: 支倉凍砂,文倉十出版社/メーカー: メディアワークス発売日: 2006/02メディア: 文庫購入: 18人 クリック: 471回この商品を含むブログ (745件) を見る 『狼と香辛料』を書くにあたり、著者の支倉凍砂はかなりの量の文献を読み込んでいたらしい。ライトノベルは、青少年向けの「軽い小説」と見なされることが多い。しかし、そのライトノベルでさえ、メガヒットの裏側にはきちんとした情報収
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
文筆業の皆さんにも知ってほしい「バージョン管理」 - Togetter