大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？ 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体
買った戸建てに付けた表札、住所はぼかした プロローグ 新型コロナが世間を騒がせ始めて以来ずっと在宅勤務をしている。 転職に伴って会社近くに引っ越したので通勤のドアtoドアで30分台を叩き出していた好立地はその活躍の機会をすっかり失った一方で、妥協した40平米の部屋の狭さと1LDK+Sの間取りが巣ごもり子育て核家族を襲った。 外で遊び足りない娘は泣き、広がった活動範囲で家中の物を無秩序に引っ掻き回すので必然的に触られたくないものは高いところに置くことになり、立体的に活用される事になった1LDKの空間は生活の難度を高めジワジワと真綿で首を締めるような状況が続いた。 住んでいたマンションは駅に近いのは良いが作りは古く、冬には窓枠が結露しカビが発生する。窓から降りる冷気はそのまま壁や床にすら結露を起こし室内はカビに見舞われた。それとの因果関係は不明だが冬場の慢性的な体調不良が家庭内の治安を更に悪化
問題解決を、セクシーに。 気候変動に立ち向かう。すべての声を一つにして。 楽しく、クールに、そしてセクシーに。 問題解決は苦しいだけではありません。 もっと肩の力を抜いて。ステーキを食べながら。 30年後のあなたは、何歳ですか？ 未来のことを、常に考えています。 30年後の自分は、何歳なのでしょうか。1 30年後には、さらに30年後のことを考えているかもしれません。 30年後の、その先へ。 足し算の答えが分からなくてもご安心を。Siriに話しかけてみてください。2 究極の反省を、決して伝わらない形で。 反省しなくてはいけません。 とても反省しています。反省している色が見えない、という点を。 Super Retina XDRディスプレイは、反省している色を鮮明に映し出します。3 アクセシビリティ機能を使うと、反省の色が見えやすくなります。 “46”、それはマジックナンバー。 30でもなく、5
お薦めの世界史の本について、3人で2時間語り合った。 世界史を学びなおす最適な入門書や、ニュースの見方が変わってしまうような一冊、さらには、歴史を語る意味や方法といったメタ歴史まで、脚本家タケハルさん、文学系Youtuberスケザネさん、そして私ことDainが、熱く語り合った。 全文はyoutubeで公開しているが、2時間超となんせ長い。なのでここでは、そこから厳選して紹介する。 因果関係を補完する『詳説 世界史研究』 スケザネ：大学生、あるいは社会人の方々にも、世界史を学ぶには、まず真っ先に「高校世界史」をオススメしたいです。世界の歴史を幅広く知るという観点から、高校世界史はベストだと思います。 代表的な高校世界史の教科書は、山川出版社の『詳説 世界史B』。世界史の概観が400ページぐらいにまとめられてて良い本なんですが、これだけだと記述が簡素で、理解するには少ししんどい。 実際、自分が
インフラエンジニア向けの書籍を取り上げ、著者と出会い、楽しく本を知り、仲間を作る場所である「インフラエンジニアBooks」。ここで、『ユーザーの問題解決とプロダクトの成功を導く エンジニアのためのドキュメントライティング』の翻訳を担当した岩瀬氏が登壇。まずは、本書籍の概要について話します。 本セッションの対象者と、セッションのゴール 岩瀬義昌氏：ご紹介いただきました、岩瀬と申します。よろしくお願いします。『ユーザーの問題解決とプロダクトの成功を導く エンジニアのためのドキュメントライティング』は、もともと『Docs for Developers: An Engineer’s Field Guide to Technical Writing』という洋書だったんですが、その翻訳をして、今回この機会をいただいています。 余談ですが、APC（株式会社エーピーコミュニケーションズ）さんが「カプセルト
By Matthew Yohe, CC BY-SA 3.0十代の子たちの不幸を説明するもっとも有望な要因「テレビなんてぶち壊せ / 新聞なんて投げ捨てろ / 田舎に行こう / 家を建てよう」――ジョン・プライン アメリカで広まっている十代の不幸について，興味を引く議論が続いている．発端は，疾病対策予防センター (CDC) の調査報告だ．これによると，アメリカの高校生たちのあいだで，哀しみや無力感が増えてきている．とくに女の子で顕著だ．たんに，聞き取り調査に対してみんながこれまでとちがう回答をしているだけじゃない．十代の自殺者も増えているし，不安や鬱の症状も増えている．2012年～2013年ごろから，事態が悪化しはじめている： Source: Twenge (2020)考えうる理由のひとつは，「2011年よりも世の中がずっとひどくなってしまったから」というものだ．テイラー・ローレンツが言うよ
例のTikTokのキーロガー疑惑について解説するよ
結論から先に。TikTokはevil。でもやじうまWatchの記事はデマに近い。 問題のやじうまWatchの記事iOS 14でバッチリ可視化、TikTokが「他アプリで入力中のテキスト」を逐一読み取る様子 https://internet.watch.impress.co.jp/docs/yajiuma/1261591.html 6/27 追記 6/26のうちに訂正された模様。よかったよかった。以下は訂正前の記述について述べたものなので、後世の人たちはそのつもりで読んでいただきたい。 この記事のどこが問題か他のアプリで入力中のテキストをほぼリアルタイムで逐一読み取っている様子を可視化したムービー いきなり最初のセンテンスから間違い。 TikTokは「他のアプリで入力中」のテキストを「ほぼリアルタイムで」「逐一」読み取っていたりしないし、元動画もそういう内容ではない。 元動画の内容は、「Ti
※2021年 3月28日 更新※ たくさんの方にご一読いただき、ありがとうございます。お読みいただいた方からご指摘を賜った点をもとに記事を修正いたしました。修正・追記箇所は末尾をご確認ください。 サーバ周りの仕組みについて、初心者でも最低限知っておくべきだと感じた内容を整理しています。 ここでいう「最低限」とは、プログラミング言語を勉強し、何かしらアプリケーションを作成して、ユーザが利用可能な状態にし（デプロイ）、公開するうえで必要になる知識のことです。 「サーバ」とは何か ユーザの要求（リクエスト）に応じて、サービスを提供（レスポンス）するコンピュータやプログラムのことを「サーバ」と言います。 例えば、ユーザが「このWebページを閲覧したい」とリクエストしたら、サーバはそのWebページの表示に必要な処理を実行し、ユーザに返します。これによってユーザが使用しているブラウザに、Webページが
#小池百合子 氏のアラビア語力は高い、というツイートをしたらバズりましたので、アラビア語の世界をもう少しご紹介しましょう。 ツイートしたように、知事はアラブ人と普通に政治経済の議論ができ、日常的（頻度は少ないでしょう）にそれを行い、かつ、接する人にその言葉が流暢であると評価されています。政治的に物議を醸しているこの問題についてあえてツイートした理由は、この事実が現在重要であるにも拘わらず、逆の風説が流布していることについて、正義を欠くと考えたからです。私は、政治家小池百合子に期待をしていますが、そのことが、同氏のアラビア語能力についての私のこの評価に影響を与えているということはありません。政治的な意見を言う前に、私にとっては自らの職業上の倫理を守ることと信用の方がよほど大切だからです。 話す力と理解する力（ヒヤリング力）語学は、一般に「読み・書き・話し・理解する」という４つの能力をバラン
Amazonのミーティングはとても奇妙な形で行われることが多い - ミーティングの最初にドキュメントを参加者が黙読するのだ。議論は全員が読み終わったことを確認してからスタートする。基本的に文章を読まずにいきなり発言し出したりということは許されない。大人数が一つの部屋に集まり、一つの文章を黙って読む姿は結構シュールである。 私はこの奇妙なミーティングをする会社に7年ほど勤めていた。こういった環境で生き残るには人に読ませる、よいドキュメントを書かねばならない。しかもアメリカで働いているのだから当然英語で書く必要がある。しかしながら私は帰国子女でもなく、特段英語が得意というわけでもない。最初の頃に書いたドキュメントは複数人にレビューされていつも真っ赤っかになっていて、そのマークアップの量を見ては鬱々としたものである。が、小さな子供とVisa問題を抱えて異国の地でクビになるわけにもいかない。英語弱
たとえ一時であっても、相手が好きで、自分が選んで結婚したんでしょう？ 誰かに強制されたり、親に決められて無理やり結婚させられたりしたわけではないんでしょう？ 「そういう相手」を選んだのはあなたじゃないですか。 「恋愛のドキドキ」を基準に選んだのはあなたでしょう？ 「恋愛相手として欲情する相手」が、結婚相手として、夫として、父親として、共同生活パートナーとして適切であるとは限らないんですよ。 「いい人なんだけどちょっと……」 「恋愛相手としてドキドキしないから……」 「私がいなくても生活していけそう……」 そういう相手は「恋愛的に昂らない」から、選択肢から外してきたんでしょう？ 恋愛能力の高い相手を優先して、その他の能力については優先順位を下げた。 あなたの選んだとおりじゃないですか。 なぜ自分が望んだとおりの選択をして、うまくいかなかったことを社会に転嫁するんですか？ なぜ社会にお金を出さ
WebデベロッパーのVictor氏による下記のツイートから始まるスレッドが大変参考になる内容だと感じたので、ご本人に許諾を得て日本語で紹介させていただくことにしました。 I reviewed 100+ user interfaces this year. Avoid the most common 18 mistakes to make your UI/UX design better 👇 — Victor (@vponamariov) July 30, 2021 私は今年100以上のユーザーインターフェースをレビューしました。あなたのUI/UXデザインをより良くするための、下記に示す18個の良くある誤ちを回避しましょう。本記事で使用する画像はすべてVictor氏のツイートから拝借しています。なお翻訳には一部私の意訳が入っていることをご了承ください。 1. 薄いコントラストの文字適切では
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
質の高い技術文書を書く方法 - As a Futurist...
ソフトウェアエンジニア、建売を買う - Software Transactional Memo
「問題解決を、セクシーに。」小泉進次郎 Powered by Apple
面白い世界史の本を3人で2時間お薦めしあった中から厳選した12冊（前編）
「ドキュメントの書き方」を体系的に学んだことがないエンジニアへ 書籍『エンジニアのためのドキュメントライティング』の概要
ノア・スミス「やっぱりもしかしてスマホがわるいのかも」（2023年3月2日）｜経済学101
【図解】初心者が知っておきたいサーバ周りの仕組みの話 - Qiita
小池都知事のアラビア語力をどう評価したらいいのかわからない方へ｜jaber
英語が苦手な人が英文Writingを学ぶにあたっておすすめの本五選｜Yuki Nakazato
恋愛結婚時代にあなたの選択の責任すべてが免除されることはない
UIデザイン時にやってしまいがちな18の誤ち｜Mikio Kiura / ANKR DESIGN