読み手につたわる文章 - テクニカルライティング - mochikoAsTech - BOOTH
72ページ / A5サイズ / 電子版はPDF（フルカラー） / 紙の本は表紙カラー、本文モノクロ 技術書典16（2023年5月25日～6月9日）の新刊「読み手につたわる文章 - テクニカルライティング」です。 「書籍版＋PDF版」はBOOTH倉庫での入荷作業が完了し次第、買えるようになります。 「入荷お知らせメールを受け取る」を押しておくと、入荷されたときにメールが届きます。 「PDF版」は名前のとおり、PDFをダウンロードできます。紙の本はついてこないので注意してください。 なおPDF版は技術書典オンラインマーケットでも購入できます。 https://techbookfest.org/product/3t8AGqtB65jsPtPhx6m5fr 「ダウンロードカード用」は、既に紙の書籍をお持ちの方向けのファイルです。紙の書籍を購入された方は、あとがきの後ろにダウンロード用のパスワードが
明日から私は一人で寝る
小学1年生、4月から2年生になる娘が言った。 「明日からは一人で寝たい」 我が家は21時を目標に家族の寝室に連れていく。 そこからが微妙に長かった。 娘はオリジナル曲の奇怪なダンスをしたり、お気に入りのぬいぐるみを並べてごっこ遊びをしたり。 1日にあった出来事を話したり、突然宇宙や自然のことを話し出したり。 早く寝て欲しくて明日も幼稚園だから！と注意するのが、明日も小学校だから！に変わっておおよそ一年。 先月まで一人で寝るのは怖い〜と寝かしつけを欲してきた娘が、今夜、あっさりと明日からは一人で寝る宣言をしてきたのだ。 あの舌っ足らずの意味不明な歌詞のうた。 全身をバタバタするダンス。 ぬいぐるみの前で幼稚園の先生ぶって遊ぶ仕草。 思わず笑いそうになりながらも、早くベッドに入りなさいと言った。 ベッドに入ってからもおしゃべりはとまらない。 ニコニコしながら話す1日のダイジェスト。 これから食
Ingressでおかしくなって和歌山県の山中で正気を取り戻した話
なああんた、あんたはゲーム脳って信じるか？ ゲーム脳なんてインチキだ、って答えるだろうなあんたは。オレも信じちゃいない。それでもゲームで人間が狂っちまうことはある。あのときオレは復讐者になっていた。警告がてら、ちょっと思い出話に付き合ってくれ。 何年か前にIngressってゲームが流行っただろ。青組と緑組にわかれて陣取りゲームやる、ポケゴーの元になったゲームだ。ポケゴーのジムやポケストップをIngressではポータルって呼ぶが、占拠したポータル同士を直線で繋ぎ合わせて三角形をつくると自分の色の陣地にできて、ヘッドフォンからは「素晴らしい成果です」とお褒めの言葉が流れてくる。シンプルに見えて奥の深いゲームだったからオレはやる気になって青色の三角をつくりはじめた。 Ingressは誰かがポータルを占拠したり三角を作ったりするたびに行動ログが流れるから、オレの成果はすべてのエージェント（プレイヤ
読みやすいドキュメントを書くために今日からできる7つのこと｜壮｜Masato Tanaka
こんにちは。壮（@sew_sou19）と申します。 メガベンチャー企業でエンジニアとして働いています。 エンジニアにジョブチェンジした当初は、ドキュメントの書き方なんてこれっぽっちも分かりませんでした。読みやすいドキュメントを書くことが本当に苦痛だったのですが、考えて、試行錯誤し続けた結果、以下のような評価を得るに至りました。 リーダーから「君は情報の整理が上手でドキュメントが本当に読みやすい。チーム全体の能力向上に繋げたいからドキュメント書く際のポイント共有してほしい」と言われたので、意識していることを言語化しつつテクニカルライティングの本でインプットしてるけど、学びが多い。ついでにnoteにもまとめてる — 壮 (@sew_sou19) November 28, 2022 そこでこのnoteでは、僕がドキュメントを作成するときに、特に意識して実践している7つのことを書きます。（本当は2
数式がある文書作成に役立つ資料まとめ | Math Relish
なかなか上手い表題を考えるのが難しかったのと， 置かれた状況によって「役立つ」の尺度が変わる． また技術文書に限るものでもないように思ったので， 単に文書とした． なんとも正確ではないが， 何も知らずに数式を書き連ねていくよりはよいだろうということで， この表題で本稿を書くことにした． ご容赦願いたい． はじめに 今やテクノロジーは高度に進化して， 様々な分野で数式を用いたコミュニケーションが必須となっている． しかし一方で数式と聞いて，その「書き方」に関して注意が払われることは意外に少ない． 清書する！ 普段，数式に馴染みのある人でも，以下の時間が大部分を占めるのではなかろうか． 計算用紙に式を書く (宿題などの)レポートを書く 板書する これらはそれこそ学生や教員の垣根なく，日々体験していることだろう． だが次の機会がそうそうない． 清書する これは「不特定多数の人に向けて投稿する」と
GitHub上に構築した小説執筆環境について
要点 小説執筆環境を GitHub 上に整備した 校正作業を自動化できた 執筆と情報管理を GitHub 上にまとめられた 小説執筆環境を GitHub 上に整備した 経緯 大学在学中や社会人 1 年目くらいまで、下記のような手法でバージョンを管理していた。 【確定版】2019 年 8 月版(2020 年 1 月 22 日改訂).docx まったく虫酸が走る。 不快極まりない。 ただちに一掃しなければならない。 趣味で不快になっていちゃ世話はない。 せめて不快さを感じない程度の環境を整備する必要があった。 執筆環境への要求事項は次のとおり。 自分でサーバ構築をせずとも使用できること バージョン管理機能が実装されていること クロスプラットフォーム対応であること 以上を満たし、かつ貧弱な端末やネットワークでも使用に堪える環境として、GitHub を選択した。 環境 前提条件 Windows10
【新日本】有頂天外オーカーンがＩＷＧＰタッグ王座陥落 女児救出報道の過大評価に増長した天罰が下る | 東スポWEB
新日本プロレス５月１日福岡ペイペイドーム大会で、ＩＷＧＰタッグ王者のグレート―Ｏ―カーンが笑止千万の王座陥落。一度も防衛を果たすことなくベルトを失った。 本来であれば新日本マットレギュラー参戦さえおこがましいレベルのオーカーンだが、大僥倖に次ぐ大僥倖とパートナーのジェフ・コブの傑出した実力に恵まれ４月両国大会でＩＷＧＰタッグを奪取。この日は初防衛戦で後藤洋央紀、ＹＯＳＨＩ―ＨＡＳＨＩの「毘沙門」、チェーズ・オーエンズ、バッドラック・ファレ組とのノータッチルールの３ＷＡＹマッチに臨んだ。 因数分解あたりから周囲に置き去りにされたオーカーンに、３ＷＡＹのような複雑なルールはもしかしたら理解できなかったのかもしれない。入場と同時にいきなり両挑戦者チームから奇襲を受けるなど、集中力も緊張感も皆無。大した見せ場もないまま毘沙門の合体技・消灯を浴びてリング外へと追いやられ、もう本当クソの役にも立たなか
うまい文章をラクに書くための「たったこれだけ」の工夫5選。 - STUDY HACKER（スタディーハッカー）｜社会人の勉強法＆英語学習
「文章をうまく書くには、やっぱり訓練が必要……？ でも面倒なことはしたくない」 「難しいことや特別なことをしなくても、文章力がアップする方法を知りたい！」 このような人に向けて、うまい文章をラクに書くための “ちょっとしたコツ” を5つご紹介します。メール、チャット、報告書など、あらゆるビジネスシーンで使えるものを集めました。誰でも簡単に実践できますから、読んだら “即” 使ってみましょう。 1. 一文を「短くする」だけ 仕事の情報は複雑で、文章にするとどうしても込み入ってしまうもの。もっとスマートに書きたいのに……と思うなら、「一文を短くするだけ」で効果的です。 数々のヒット作を生み出すコピーライターで、“端的に文章を書くプロ” である橋口幸生氏。同氏は、読みやすい文章を書くには、一文を40～60字以内にまで短くするとよいと言います。 これは、一文に書く内容をひとつに絞ると実現できるとの
エンジニアのための、いますぐ使える文章校正テクニック - ICS MEDIA
ウェブ制作や開発の仕事で文章を扱う機会は多いはず。書き手は不自然に思っていない文章でも、読み手は違和感をもっていることがあります。文章校正テクニックを覚えるだけでおかしな表現は少なくなり、読みやすい文章を書けるようになります。 本記事では、ICS MEDIAで実践している文章校正の一例を紹介します。 レベル1、基本的な校正ルールを使う いろんな場面で使える基本的な文章校正テクニックから紹介します。 テクノロジー系の名詞は正しく記載しているか テクノロジー系の名詞を間違って使うと、「本当に技術に詳しいの？」と読者からの信頼度が下がります。名詞は大文字小文字、スペース有無含めて正確に記述しましょう。 Github → GitHub（Hは大文字） Javascript → JavaScript（Sは大文字） After Effect → After Effects（複数形の「s」を忘れてはいけな
仙台のすごいキャッチ
仕事の関係で、しばらく仙台に来ている。会社の手配したホテルに滞在しているのだが、出張先とホテルの位置関係上、どうしても国分町という仙台における歌舞伎町のような繁華街を通らざるを得ない。このご時世あまりそういった場所へ近づきたくないということもあり必ずしも快く思っていなかたのだが、足早にホテルへ帰ろうとする私に声をかけてくる有象無象のキャッチのなかで、ひとりだけ異彩を放っている男がいることにある日気がついた。 だいたいキャッチというものは「キャバクラいかがっすか」「さ、居酒屋の、ご利用は」「お店お探しですか」の３パターンしかボイスの収録がされていないものと思っていたが、その男だけはそれらの聞き馴染んだセリフが一切なく、あまりに独特の語彙、それも妙にかっこいいコピーライティングのような文句でキャッチ行為を行っているのである。この数週間ほぼ毎日のように彼の慧句を聞いてきた中で、とくに印象に残って
伝わる文章作成の基本を学ぶための記事・学習コンテンツのまとめ - Qiita
短いメッセージを書くことはできても、まとまった文章を書くのに苦労している人は多いのではないでしょうか。 この記事では、まとまった文章を作るときの技術を学ぶことができる記事や学習コンテンツを紹介します。新人エンジニア向けです。 文章の「型」を学ぶ まとまった文章を書くには、「型」が必要です。頻繁に使うものは、「型」を覚えてしまいしましょう。 バグレポートの書き方を学ぶ エンジニアとして書く文章の代表例が、バグレポートです。 バグレポートでありがちな失敗として「何が問題だと思っているのか」が伝わらないというものがあります。 これを防ぐために、「期待する結果」「実際の結果」「再現手順」の3つを必ず書くようにしましょう。 質問の書き方を学ぶ エンジニアが扱う技術は、最初はわからないことだらけです。 それを解決するために、質問の文章を作成する技術が必要となります。 概ね下記の4つの情報があれば、良い
「Otter」「DeepL翻訳」「Grammarly」など、便利なAIツールを駆使して英文ライティングに挑戦 - ENGLISH JOURNAL ONLINE
「Otter」「DeepL翻訳」「Grammarly」など、便利なAIツールを駆使して英文ライティングに挑戦 近年は人工知能（AI）を活用した自動翻訳や自動添削ツールが増えています。Otter、DeepL翻訳、Grammarlyなど、自分の英語力の足りない部分を補ってくれる便利なAIツールを駆使して、英文ライティングに挑戦してみましょう。 英文ライティングに自信がない人に助け舟リーディングやスピーキングの練習に比べると、後回しになってしまいがちなライティングですが、単なる語彙力や文法力だけでなく、表現の豊富さや、文章の構造など、総合的な語学力が求められる、非常に高度な分野だと言えます。英語の上達を目指している人ならば、常日頃からライティング力を高める勉強をしておきたいものです。 とはいえ、誰もがそんなに律儀で計画的とは限らないのが現実です。実際には、「来週までに英語で資料を準備しておかねば
Apple 風文体の力を、あなたにも。
短くて身近な言葉。だから、わかりやすい。 余計な修飾にさようなら。伝えたいことだけが伝わります。 具体的な説明で、説得力を加えましょう。否定表現は最小限。エンパワーメントのための強調はたっぷりと。多彩な文末の作り出すリズムが、どんな文章にも、魔法のようにレスをもたらします。 最先端の力強いスタイルで、記事は一気に注目エントリーへ。マーケティングと広報の勉強にもなります。プライベートな日記で、人気者に。 anond:20210424193915
情報ではなく経験をアウトプットすること - 余白
調べれば大抵の情報は誰でも手に入る今日このごろ。特に技術的な情報はオープンソースで一次情報へのアクセスは容易になった。 それと同時に繰り返し言われるアウトプットの重要性。 しかし、ブログやLTなどでアウトプットしても、「もっと質のいい情報があるのに自分がアウトプットする必要があるのか」「逆にノイズになるだけじゃないか」というような考えになってしまう人もいるのではないか。 そんな架空の声にお応えして、それでもなおあえて、一次情報ではない「あなたのアウトプット」の重要性を伝えてみようと思う。 実際にやる人は多くない 定量的なデータがあるわけではないが、直感的に共感してもらえるだろう。 ある技術や手法が話題になったとして、それを情報として知っている人はこの時代いくらでもいる。 だが、それを実際にその手でやったことがあるというだけでかなり群衆からは抜きん出た経験を持つことになる。 ましてやそれをや
執筆者やライターに向けて、編集者からのお願い→原稿を書き終わったらチェックして欲しい点がこちら
中村明博（編集者） @naka727 【編集者からのお願い】 著者やライターさんへ、原稿が完成したら、 ・「という」をカット ・「と思います」をカット ・「こと」をカット ・「もの」をカット ・過剰敬語をカット できないか見直していただけないでしょうか。ざっとでもかまいません。関係者全員が幸せになります。なにとぞ、、！ 中村明博（編集者） @naka727 【なぜこんなお願いをするか】 誰かが直さなければならないからです。その分、「磨き上げ」の時間が減り、本のクオリティーが落ちます。本の売り上げが落ち、関係者全員が不幸になるためです。 中村明博（編集者） @naka727 さらに可能なら、 ・40字を超える長文は短く・簡潔にする ・「これから説明します」的な余計な前置きはカット ・「ひとつ・1つ」「ひとり・1人」あたりの表記統一を行う このあたりまで見ていただけると、編集者はみな泣いて喜び
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
IT英語スタイルガイド | IT英語スタイルガイド
有名コピペ「初カキコ…ども…」の続きをChatGPTに書かせてみたらちょっとポジティブな感じにしてきた件
テクニカルライティングの基本
小説の推敲補助ソフト「Novel Supporter」に隠れた文章癖をあぶり出す分析機能／文字種・文章長・段落長などの推移をグラフ化
女子高生の私マガジン｜潮井エムコ｜note
