サクサク読めて、
アプリ限定の機能も多数！
アプリで開く
拙著『GitHub CI/CD実践ガイド』は内容だけでなく、読書体験にもこだわりました。AmazonやSNSでも読みやすいという声は多く、技術書としては珍しい観点で評価を得ています。Amazonにおける「GitHub CI/CD実践ガイド」の読者レビュー本記事では書籍の「読みやすさ」という切り口から、執筆の舞台裏を紹介します。 最高の読書体験を目指す技術書の使命は、役立つ情報を届けることです。しかし筆者は役立つだけでなく、読んでいて心地よい書籍にしたいと考えました。そこでまず決めたのが「最高の読書体験を目指す」ことです。そして最高の読書体験を実現するため、次のような設計原則を定めて執筆しました。 シンプルにする：短い文章・簡潔なコード・直感的な図表へと磨き上げる ノイズを減らす：難しい表現は避け、読者を迷わせる要素は徹底的に取り除く テンポを重視する：読者の集中力を削がないよう、読ん
「雑誌の投稿コーナーに載る為に必死に文章を練習して、他人に読んでもらう文章を書くことの困難さに気付いた人」というのがどれくらいいるのか分かりませんが、私はその中の一人です。 この記事で書きたいことは、大体以下のような内容です。 ・昔、「ゲーメスト」という超面白いゲーム雑誌がありました ・読者投稿コーナーに掲載される為、いわゆるハガキ職人を目指して頑張っていました ・全然載らなかった為、兄に頼み込んで投稿内容を添削してもらいました ・その時の兄の言葉で、「文章というものは、書いた本人が読む時と他人が読む時で全く違うものになる」ということに気づきました ・兄に添削してもらうようになってめでたく投稿コーナーへの掲載の夢が叶い、以来文章を書き続けています ・載らなくても載らなくても全く飽きずに投稿し続けた、という諦めの悪さも、一つの資質だったのかも知れません ・どんな文章であれ、「レビュー」「壁打
突然ですが、質問です！ 以下の文章で、登場人物が実際に声に出して言っている部分と、心の中で思い浮かべている部分はどこでしょうか。 「みんなはね、ずいぶん走ったけれども遅れてしまったよ。ザネリもね、ずいぶん走ったけれども追いつかなかった」と言いました。 ジョバンニは、 （そうだ、ぼくたちはいま、いっしょにさそって出かけたのだ）とおもいながら、 「どこかで待っていようか」と言いました。青空文庫 宮沢賢治『銀河鉄道の夜』 https://www.aozora.gr.jp/cards/000081/files/43737_19215.html 答えは簡単ですね。 「 」の中の言葉が声に出して言っている部分、（ ）の中の言葉が心の中で思い浮かべている部分です。 前後の文章からも読み取れると思いますが、括弧の使い分けがされていることで、より分かりやすくなっています。 このように括弧類は主に文章内で会
事故も虐殺も瞬きの間に脳内を過ぎ去ってゆく。歴史の終わりが語られて久しいが、実際には僕たちの物語る能力を現実が超えはじめたのだろう――グローバル化とも、情報化とも、加速化ともいえるが、詳細はこの記事ではふれない。 デジタルゲームの世界は話題の移り変わりが激しい。 新作発表やトレーラー公開に始まり、先行プレイにリリース直後のインプレッション、攻略や小ネタ集、毎年恒例ＧＯＴＹの発表――。 YouTube はそれらにあやかったレビューやネタ動画に溢れ、Twitch では配信者たちがスキルの高さとリアクションの大きさを競い、グーグル検索はＳＥＯ対策に特化した企業主導型ゲーム攻略サイトと２ｃｈのまとめサイトに牛耳られている。 もちろん、そうした言論空間で掻き消されているのは批評だ――作品の良し悪しを論じるという意味での。 去年、ほぼ全ての大手海外レビューサイトで驚異のほぼ満点と記録的なセールスを叩
プロフェッショナルライティングガイドとは このガイドラインは、日本語ライティングの基本技術をまとめた文章です。参照先としているのは、欧米で標準となっているテクニカルライティング技術、日本国政府の公式文書、新聞社・出版社で定められている規準、著名な学問研究など、公的な判断に基づく規準です。できるだけ主観ではない基準を指針とすることで、文章を書く際のベースとなる技術として役立てることを目的としています。 ライティングに技術が必要な理由 論理的な文章、公式な文章を、他人に正確に理解してもらうためには、書き手の技術が求められます。それは、読み手は楽しむために文章を読んでいるのではなく、情報を得るために文章を読んでいるからです。忙しい状況の中で短時間で効率的に情報を得るために、読み手は読み飛ばしながら文章を読みます。これを「拾い読み」と言います。集中して読む時に行われるディープリーディングとは異なり
”ユーニス・パーチマンがカヴァデイル一家を殺したのは、読み書きができなかったためである” という一文から始まる「ロウフィールド館の惨劇」というミステリ小説がある。 「読み書きができない家政婦」がその劣等感をこじらせ、一家惨殺に及ぶまでを追いかける話で、映画化もされている。 3年ほど前に知人のすすめで読んだのだが、倒叙ものや、変わった話が好きな方は読んでみても良いと思う。 ＊ ただ、ストーリーの強烈さより私が覚えているのは、文盲までいかずとも「文章が正確に読めない人」は、今でもかなりいるな、と思ったことである。 例えば、リーダーが部下に、こんなメールを送ったとする。250文字だから、ツイート2つ分弱だ。 明日の朝10時までに、私をCCに入れて、Yさんにメールを送っておいてください。内容は次回の定例までの宿題事項と、現在までに積み残している課題の一覧の二つです。積み残しの課題については、期限を
相手に誠実に、わかりやすい文章を書くための心がけをまとめました。 どういう思考プロセスからどんな表現が生まれるのか、参考として実例を紹介しています。実際に読み比べ、SmartHRの従業員として何かを伝えようとするときの、参考にしてください。 伝わる文章のガイドライン 何を伝えるかによって、必要な情報の量や説明の粒度は異なります。 情報が不足していたり、逆に情報が多すぎたりすると、読者が意図を読み取れないことがあります。 読み手となる相手の状況（読む場面、事前知識など）を踏まえ、言葉にする内容や表現を厳選することが大切です。 目的に合わせて情報を取捨選択する 読者の目線に立ち、コンテンツの目的に合わせて情報を取捨選択しましょう。 実例1：法律や業務に関わる記事 目的 業務に関係する「厚生年金保険」について正確に知りたいと思っている人に、わかりやすく内容を伝える。 Before 日本の年金制度
「本の編集ではテキスト原稿のバージョン管理しか勝たん」という信念を押し通してきて、そろそろ20年近くになりました。厳密には19年くらいだと思うので、タイトルは誇張です。 久しぶりに編集者にとってのバージョン管理に言及したくなったので書いてみました。 目次です。 なんで「テキスト原稿のバージョン管理」の話をしなくなったか 「誌面レイアウトしたPDFとか紙に赤字を入れる」で編集するのもう無理… そこでテキスト原稿のバージョン管理 具体的にどうすればいいのさ 前提からつらつら書いていたらやたらに長くなりそうだったので、全部捨てて書き直したのに、それでもそれなりに長くなってしまった。 最後の節に書いた「 「原稿の移り変わり」を管理するのではなく、「原稿にありうる無数の可能性」を管理する 」というヒントだけでも持ち帰ってもらえればうれしいです。 なんで「テキスト原稿のバージョン管理」の話をしなくなっ
こう言い換えろ→論文に死んでも書いてはいけない言葉３０読書猿Classic: between / beyond readers を書いたとき、「あとは穴埋めしたら論文を出力してるものが作れないか」みたいな話があったので、作ってみた。 何であれ、文章を書く骨法は、書きたいことではなく、書くべきことを（そしてそれだけを）書くことである。 問題は何を書くべきかであるが、幸いにして、論文については後述するようにほとんど決まっている。 結論から言えば、以下の表を埋めていくだけで、論文の骨組みができあがる。 必要な項目は揃い、しかるべき順序で並ぶ。 論文穴埋めシート こんな簡単な穴埋め表がこれまであまり取り上げられなかったのは、わざわざ作るまでもないことも勿論あるが、その他にも次のような理由がある。 つまり、こうした穴埋め表が、 あなたは論文が書けないのではない。 研究ができないのだ。 という目の当
朝日新聞社は4月2日、指定した字数や割合に長文を要約する「長文要約生成API」を開発したと発表した。評価用途に限り、無償で利用できる。会議の議事録や、採用活動で受け付けるエントリーシートの速読などに役立てられるという。
大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近はAmazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ本番環境に変更を加えるにあたっての包括的な情報や具体
某シロクマせんせのエントリに端を発する言及する文化が云々ってやつ読んでた、だいぶ前にブログとかやめたおっさんの感想です。 ネットの一般層への普及をどこに置くかなんだけど、自分の肌感覚でいうと、２００８年～２０１０年くらい。例によって根拠はない。少なくとも２０１０年以降はＳＮＳからの流入がだいぶ多くなったような感じ。拡散の速度もそのへんで上がったような。 先に結論だけいっとくと、ネットの主役がだれになったか、ということだと思う。送る側、受ける側両方含めて。 ネットの黎明期ってのをどこに置くかはまた議論になるところだが、まあ原ネット期みたいなのは、１９９５年～２０００年くらいのあいだかなと思う。その時期にネットに参入した人間って、基本的に送り手も受け手も文章に関するなんらかの訓練を受けた人が多かったんじゃないだろうか。だから、それらの人に対応したコンテンツが盛り上がる傾向があった。それ以降はそ
現在私は工場勤務で、昼勤夜勤を繰り返す部署にいる。工場の御多分に洩れず、最寄り駅に各駅停車しか止まらないような田舎に職場があり、住んでいるのも各駅停車しか止まらない安さだけが売りのアパートである。夜勤の場合、いつ終わっても30分は電車を待つ必要がある。 私は、かつてこの30分が嫌いで仕方がなかった。 工場勤務は退屈である。ただ同じ作業を繰り返すのみ。作業をしながら考え事をするか、うるさい環境を利用してそこそこの音量で歌うくらいしか退屈しのぎがない。そんな退屈が終わった後に30分も無為な時間を過ごしたくない、早く帰って飯食って酒飲んで寝たい、以外の感情がなかった。 去年の今頃、勤務中退屈しのぎに考えていたことを、30分の退屈しのぎに文章に起こすことを始めた。工場勤務者の御多分に洩れず、私は頭が良くない。私がそれまでに書いた文章なんて、2ページと1行の読書感想文が恐らく最長だろう。四苦八苦しな
2018年6月2日に東京・下北沢の書店「本屋B&B」で「［京極夏彦×装丁夜話］京極夏彦の版面」というイベントが開催された。このイベントを企画したのは、装丁家の折原カズヒロさんと坂野公一さん。今回は、坂野さんがこれまでに何冊もの装丁を手掛けた作家京極夏彦さんを呼んで、版面（はんめん、はんづら）づくりの詳細を語ってもらった。 今回はその後編である。 前編はこちら http://jbpress.ismedia.jp/articles/-/53511 ルビを振る基準のマニュアルを作成 版面をパッと見たときに、ルビの存在はかなり大きなウェイトを占めていることがわかります。傍点よりも存在感があるわけで。難読漢字には比較的画数の多い漢字が多いです。画数の多い漢字の横にルビがあるかないかは、大きな問題になります。 さらに、ルビには位置の問題があります。肩付き、中付き、3字ルビ（1文字の漢字に3文字のルビが
大学生だった当時、梅田望夫の本を読んではてなにやってきた僕は、ブログ論壇への憧れだけがあって、技術者にもなれず、時流のテーマに対して書くべきテーマを持たず、ただ実家の宗教に対する恨みだけを書き綴っていた。 もちろん、そんなものを好きこのんで読む人はいなくて、ただ虚無へとテキストを放り込んでいたのだけだど、いつからか、ある程度パターンを獲得して、その真似をするようになって、成功失敗を繰り返して、それなりにPDCAを回してきたと思う。思えば、その過程でいろんな人のヘイトを買った気がする。 人間のテキストの読み方、その反応、というのはパターンを、いくつか書き起こしてみる。 読者は、ファーストビューのレイアウトで、読む読まないを決める タイトルは記事の印象の5割 章タイトルが残りの半分本文はほとんど読み飛ばされる 書き手としては単語の印象の連なりでイメージを形成することになる 段落が均等に分割さ
渡辺です。 昨日のエントリーが結構反響大きめだったので、第二弾です。 文章校正をしていてよくあるパターンを幾つか抽出してみました。 ただし、前回紹介しているパターンは除外していますので、あわせて確認ください。 重複を減らす 文章校正の基礎は 重複を減らす ことです。 次の文章を見てみましょう。AWSを使い慣れている人にとっては簡単な作業ですが、使い慣れていないと戸惑う所も多いところです。 この文章がくどく感じる理由は、「使い慣れている」が重複していることです。 前後関係もありますが「ところ」がなにを指しているのかも曖昧ですね。 後半の「使い慣れている」を削除し、バランスを取るために作業を後ろに移動しました。 さらに、前の文章を受けるため、「これは」を追加します。 これは、AWSを使い慣れている人にとっては簡単ですが、そうでないと戸惑う作業です。 スッキリしました。 しかし、「慣れていると
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
