はじめに エンジニアにとって、仕様書などの技術的な文章を書くこと（テクニカルライティングとも言います）は避けて通れません。ただ20年来多くのエンジニアの方々と同僚として接してきて思うことは、エンジニアの方の中には「文章を書く」ということに苦手意識がある方が一定数いるということです。 でもこの「テクニカルライティング」のスキルは、才能というよりは一種の「技能」だと思うんです。ある一定の原理原則を理解して実践を繰り返すことで、必ず一定レベルで習得できるものだと著者は信じています。 もしこのテクニカルライティングの原理原則をまだ体系的に学習したことがない、または過去学習したが改めて再学習したいという方に、お勧めのコンテンツを見つけたのでご紹介します。 https://developers.google.com/tech-writing Every engineer is also a write
消費税2045
2045年、日本。 1989年に導入され、2019年に軽減税率を取り入れた消費税は、その後奢侈税やガソリン税などを取り込み続け、巨大で複雑怪奇なシステムと化していた。軽減税率があり、世帯収入による免除措置があり、激変緩和措置があり、その例外があり、さらにその例外があった。あるフードコートは近隣の小学校からちょうど300mの距離にあったため、小学校に近い東側で食べるか遠い西側で食べるかで税率が変わった。ある喫茶店では時間帯とテーブルによって同じコーヒーの税率が24段階に変わることが分かった。もはや正しい税率は誰にも分からなかった。国税庁や税務署の問い合わせ窓口はパンクしていた。新商品のメロンパンの税率について確認するため24時間ぶっ続けで電話を耳に押し当てていたパン屋の店主が倒れて入院した。人々は皆疲れ果てていた。 世論は財務省を容赦なしに糾弾し、政治家も財務省さえ叩けば国民の受けが取れると
リアルタイム共同編集のアルゴリズム (Operational Transformation; OT) を理解する試み – RORO
Google Docsのように文書を複数人でリアルタイムに共同編集できるアプリケーションがあります。あのような機能は、多かれ少なかれ、Operational Transformation (OT; 操作変換) という考え方を使って実現されているようです。興味があったので、このOTについて調べてみました。 (追記: これからは OT でなく CRDT だという話 → I was wrong. CRDTs are the future) なおGoogle Docsではいわゆる「リッチテキスト」を共同編集できますが、ここでは話を簡単にするために「プレーンテキスト」を共同編集することを想定します。 リアルタイム共同編集の流れ 共同編集システムの登場人物は次の通りです： サーバ x 1（各クライアントから届く編集操作をもとに、最新の文書を保持します） クライアント x N（文書を編集する側です） そ
「論文入門」というより「学問全般への入門」・小熊英二『基礎からわかる論文の書き方』 - そういちコラム
このあいだ小熊英二『基礎からわかる論文の書き方』（講談社現代新書、2022年）を読みました。 本書の話をする前に、著者の小熊英二さん（1962～）について。それが本書を語るうえで大事なのです。ご存じの方も再確認ということで。 ＊＊＊ 小熊さんは著名な社会学者で慶応義塾大学教授。東京大学の農学部を卒業後、岩波書店に数年勤務しましたが、東大の社会科学系の大学院に入りなおして博士号を取得。 大学院在学中に、修士論文を書籍化した『単一民族神話の起源』（1995年）が出版され、評判となる。 その後は博士論文にもとづく『〈日本人〉の境界』（1998年）や、『〈民主〉と〈愛国〉』（2002年）、『１９６８（上・下）』（2009年）などを著す。これらの代表作はいずれも、近現代の日本の社会・思想を扱った学術的な大著です。このほかにも、話題になったいくつもの著作がある。 それらの仕事は高い評価を得ていますが、
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい - Qiita