はじめに エンジニアにとって、仕様書などの技術的な文章を書くこと（テクニカルライティングとも言います）は避けて通れません。ただ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年）などを著す。これらの代表作はいずれも、近現代の日本の社会・思想を扱った学術的な大著です。このほかにも、話題になったいくつもの著作がある。 それらの仕事は高い評価を得ていますが、
もう読んでくれる人がいなくなって、話題にも、お金にもならない『ブログ』というもの - いつか電池がきれるまで
yutoma233.hatenablog.com 『おのにち』さんは「はてなブログ」を長い間書いておられる方で、僕とは直接の絡みはほとんどないものの、固定読者も大勢いて、マイペースで更新されているのだろうな、と思っていました。 別にブログをやめるとかそういう話じゃなくて、『はてなブログ』有料版の期限が切れたのを延長せずに無料版でやります、というだけの話ではあるのだけれど、最後のほうに、こんな文章があったのです。 最近は、昔感じていたブログへの熱意みたいなものが残念ながら薄れてきつつあるんですけど、それでもやっぱり書くことは楽しいし、同じブログ仲間だ！と親近感を抱いている人達もたくさんいるので、これからも細々と続けていけたらいいなぁと。 ああ、ブログへの熱意みたいなものが薄れてきているのは、僕だけじゃないんだな、と。 それは別に今にはじまったことではなくて、もう5年前くらいから、僕が書いてい
LINEの社内には「テクニカルライティング」の専門チームがあります - LINE ENGINEERING
こんにちは、Developer Contentチームのmochikoです。LINE株式会社でテクニカルライターとして働いています。今日は「テクニカルライター」というお仕事と、LINEにあるテクニカルライティングの専門チームについてお話しします。 テクニカルライターという職種があります テクニカルライターって何をしてるの？何を書くの？ ドキュメントはどうやって書いてるの？ どんなメンバーで仕事をしてるの？ ドキュメントを書く以外にこんなこともしているよ でもドキュメントを書くだけだと技術力が下がらない？ どんな人がテクニカルライターに向いてるの？ テクニカルライターという職種があります 私はもともとウェブ制作会社のインフラエンジニアでした。とある技術書を書いたことをきっかけに「テクニカルライターとして一緒に働きませんか？」と声をかけてもらい、LINEへ転職するに至ったのですが、実はお誘いをい
iPhone標準搭載の「ジャーナル」。そもそもDiaryとJournalって何が違うんだっけ？～使わないともったいないジャーナルしたくなるアプリ～ - BCN＋R
2023年11月にApple純正の「日記」アプリである「ジャーナル」がiPhone向けに公開された。記録をつけるアプリとしては、iPhoneの登場時から搭載されている「メモ」アプリがあるのに、あえて「ジャーナル」をリリースしたポイントはどこにあるのか？そして「ジャーナル」は日記アプリとして最強なのか？日記が大好きで、紙の10年日記を20年以上つけている筆者が、「ジャーナル」の魅力と弱点、その弱点を補うアプリについて紹介する。 Appleから「ジャーナル」がリリースされたけど、日本人には「日記」ではない iOS 17が発表されたとき、目玉機能の一つとしてお披露目されたのが日記アプリ「ジャーナル」だ。 iPhone内に記録されている写真や位置情報、Apple Musicで聴いた音楽などをトリガーとして、その時に感じたことや自分が考えたことの記録がスムーズにできるようになった。 日記と言えば、ま
結構少数派なんかな？ CD VS サブスクの話を見ると、いつも「物理媒体のCDを所有する」か「サブスクだけで音源も所有しないか」の2択みたいな話になりがちな気がする 自分の場合は学生時代からずっとレンタルに頼っていて、CDはよっぽどほしいアルバムか、レンタルや配信販売もしていないものぐらいしか買ってない。 でなんで自分はそういう価値観なのかなと整理してみると 学生時代はお金もなく、聞きたい膨大な音楽を全て購入するのは現実的に無理だった。その習慣が続いている部分はある。 サブスクは突然音源が配信されなくなるリスクがある（と思っていた時代もあったけど今は理由としては小さくなっている気はする） サブスク配信されていない音源と配信されている音源を1つのデバイスでシャッフルして聞くのが難しい（ので全部音源してウォークマンにまとめて突っ込んで聞くのが楽だと思ってしまう）物理媒体がなくても、ローカルの音
この文章を、 小田原のTipy records innと、 あの日 あの場所で 助けてくれたみなさんに、贈ります。 202X年の春。私は、何もかも消沈していた。 食欲消沈。仕事消沈。ぜーんぶ消沈。自分だけの話じゃないので詳細は書けないんだけど、とにかく意気消沈祭。もういっそ、私ごと全部消沈してしまえ。そんぐらいのテンションだった。 ある日、仕事仲間のYさんが、心配して連絡をくれた。 「まずは息抜きに、小田原へ行きませんか？ 友達がやってるいい宿があるんですよ」 「行きます」とすぐに返事し、夜行バスを予約。Yさんと会って喋りたかったし、行ったことのない、私のことを誰も知らないまちに行きたかった。 朝、小田原に着いた。 駅前の「ケルン」という喫茶店で待ち合わせ。おばあさんが作り、おじいさんが運んでくれるミルクセーキが絶品らしい。もちろん頼む。Yさんはコーヒー。「これも絶品なんだよ」と、朝からナ
DeepL Write is leaving beta soon. You’ll be able to purchase a paid version for unlimited usage and maximum data security.
If you’re looking to restore (or introduce) a little order to your life, Craft will fall somewhere between “immediately helpful” and “enough to bring a tear to your eye.” This productivity app is so versatile that it’s hard to define: It’s for taking notes, writing to-do lists, organizing important documents, organizing unimportant documents, stashing away random scraps and, ultimately, transformi
Message Passing は N 人のプログラマ (jmuk, karino, kzys, morrita, shinh) が話をふったりふられたりしつつプログラミングやソフトウェア開発の雑談をするブログです。意見は書き手個人の見解です。どうみても。 Message Passing is licensed under CC-NC-SA. It has a feed and is hosted by a GitHub organization. Uses this for the OG image.
A new Substack from the Pulitzer prize and MacArthur fellowship winner, Junot Díaz shares writing, world-building strategies, and considers the creative process in StoryWorlds.
人工知能（AI）はさまざまなことをうまくやってのける。その1つは大学の期末レポートだ。まあまあな出来だが、それでも率直に言ってすごいことだ。 これは、学生と教育者のためのリソースサイトEduRefの実験結果だ。この実験は、深層学習による言語予測モデル「GPT-3」が匿名でレポートを提出し、合格点を獲得できるかどうかを明らかにするというものだ。 EduRefは「われわれは複数の教授にレポートの課題を作ってもらい、その課題を大学を卒業したばかりの人々と学生のグループ、そしてGPT-3に提示してレポートを書かせた。GPT-3のものを含むレポートを匿名で教授に提出して採点させ、レポート提出者についての考察を聞くフォローアップ調査をした」という。その結果、AIは驚くべき自然言語能力を示した。 GPT-3（Generative Pre-trained Transformer 3）というこのAIは、20
文章についての対談 最近みつけた「ストーン」という書く気分を高めるアプリの公式HPに掲載されている "物書きの手引き"というコーナー。 文章や書くことについてのインタビューのウェブ連載がどれも良いので軽く紹介。 編集者やライターはもちろん、哲学者から書体設計士、翻訳家、校正者、ミュージシャン、写真家、歌人などいろんなジャンルの職業の話が読めるのでなかなか面白い。 印象に残ったものをいくつか。 stone-type.jp 永井 哲学対話の始め方は人によってさまざまなのですが、私はまずこの場が非日常な空間であるということをはっきり言葉にします。なぜかというと、枠組みを意識的につくらないと対話は現れてこないと考えているからです。そして次に「よく聞く」「えらい人の言葉を使わない」「人それぞれで終わらせない」という3つの約束をします。3つ目の「人それぞれで終わらせない」というのは、あくまでスタート地
A privacy-first, open-source platform for knowledge management and collaboration.
誰にも見せない日記を書く - 吸い込む
1年ほど前から紙の日記を再開した。 日記自体は小学生の頃から「数日おきに気が向いたら書く」くらいの習慣になっていたが、社会人になってからはアプリやスマホのメモ帳で済ませたり、SNSやブログで日記欲を満たせていたりと、紙の日記帳からは足が遠のいていた。 書きたいだけ・吐き出したいだけであればアプリやSNSでも良いのだが、「振り返りたい」となるとやはり紙媒体が良いなと気づいたのが昨年のこと。ぺらりと紙をめくりながら過去の自分を振り返るのは、スクロールでは味わえないほっとできる感覚がある。 試行錯誤しながらも、 ①まずは日記を書き始める ②日記を継続させる ③自分にあった日記にシフトする という3段階を経て、2年以上楽しく日記を続けられている。 2分もあれば埋められる日記帳を選ぶ しばらくぶりの紙媒体で継続できるか少し不安。まずは手軽に試してみようと手に取ったのは、無印良品のマンスリースケジュー
Trinkaの文法チェッカーは、単語の選択、語法、文体などの高度な文法チェックから、単語数の削減まで、包括的に英文を改善します Wordファイルの自動校正では、元の書式を保持したままの英文校正、スタイルガイドへの準拠などが可能で、変更履歴付きのファイルをダウンロードできます。原稿の言語スコアも確認いただけます。
【A面】 「ブログは何を書いたって構わない、自分だけのスペースだ」みたいな言葉を信じていたのに、きっと今の私はそうなっていないし、そういう自由なブログを信念にしていたブロガーたちは去ってしまった。口ずさむようにブログを書くことなんて、もうできない。 何者かになると口ずさむようにブログが書けなくなる 口ずさむようにブログが書けなくなったのは、年を取ったせい、人生の残り時間が意識されるせいもある。ブログを口ずさむ時間があったら、人生の残り時間を費やすに値すること・タイパ的に有意味とわかっているものに時間を費やしたほうがいい、などと考えている自分がいる。ほんとうは、それほど単純ではない。たとえば商業企画の原稿やそのための文献読みなどに時間を振り分け過ぎると、それ自体、作業効率を低下させる。ときには口ずさむように文章を書く時間をもうけたほうが作業効率は上がるし、案外、そういう隙間の時間から面白いア
Diátaxis
A systematic approach to technical documentation authoring. Diátaxis is a way of thinking about and doing documentation. It prescribes approaches to content, architecture and form that emerge from a systematic approach to understanding the needs of documentation users. Diátaxis identifies four distinct needs, and four corresponding forms of documentation - tutorials, how-to guides, technical refer
2018/06/12 短い文を心がければ悪文の七、八割は退治することができる。短い文の上限は句読点込みで五〇字から六〇字である。 ― 『日本語作文術』, 野内良三, 中公新書2056, 2010. はじめに 梅棹忠夫さんの文章の「一文の平均はおよそ四〇字前後」(『ウメサオタダオが語る、梅棹忠夫』, p86)といわれている。梅棹さんの文章はわかりやすい。そのかきかたをみならう努力をするべきだ。そう主張しているひともいる。その一方で、梅棹さんの文章は、よみやすいけれど、ぜったいにまねできない。そう主張しているひともいる。 いま、平均文長40字以下という文章が、毎日、つくられているウェブサイトがある。外国人や、小中学生のために、「やさしい日本語」で記事がかかれている「やさしい日本語で書いたニュース」のサイトだ。 先月、「やさしい日本語ニュースの制作支援システム」という論文が公開された。 「やさし
「継続は力なり」。そうかもしれない。だが継続は才能でもある。
文才。 私が欲しいと思うもの。 されど決して届かぬもの。 00年代の前半、テキストサイトと呼ばれる文章をウリにするウェブサイトが繁茂していた頃、私はさまざまなテキストサイトのウェブマスターの文章を読んでまわり、自分には文才が決定的に欠けていると感じていた。 優れたテキストサイトの文章にはきらめきや輝きがあった。しようもない出来事やなにげない日常、そういったものでさえ、執筆者というフィルタにかけられると面白くなったり美しくなったりする、そういうサイトを尊敬半分、やっかみ半分の気持ちで私は眺めていた。 それから20年以上が経ち、こうして私はまだ文章に張り付き続けているわけだけど、文才が身に付いたとは感じられない。 後で書くように、まあ……ある程度は上手くなった。 それでも、あの時のテキストサイトの人気者たちのような面白さ、美しさを再現するには遠い。「何をもって文才と呼ぶのか」という定義問題はあ
マイクロブログの思想をまとめた「Indie Microblogging」を読んだ感想 | 世界のねじを巻くラジオ
micro.blogについてのテキスト 以前ねじまきブログで紹介したインディーウェブの思想に則ったmicro.blogというサービス。 開発者のManton Reece氏が書いたインディーマイクロブログについての説明書かつ思想書的な文章である「Indie Microblogging」がなかなか興味深かったので軽く読んでみた。 →https://book.micro.blog/ 印象に残った部分を箇条書きで： “The most valuable of all talents is that of never using two words when one will do.” — Thomas Jefferson という引用から始まっているのがアツい。 独自ドメインを使っての発信が前提 (Part1) 個人のドメイン名でブログを書くことは、Web の将来への一種の投資である WordPre
些事にこだわり｜webちくま
1936年、東京生まれ。映画評論家、フランス文学者。60年、東京大学文学部仏文学科卒業。65年、パリ大学大学院で博士号取得。東京大学教養学部教授を経て、東京大学第26代総長。映画雑誌「リュミエール」の創刊編集長も務める。77年、『反=日本語論』で読売文学賞、83年、『監督小津安二郎』(仏訳)で映画書翻訳最高賞、89年、『凡庸な芸術家の肖像』で芸術選奨文部大臣賞、2016年『伯爵夫人』で三島由紀夫賞をそれぞれ受賞。 ＡＢＪマークは、この電子書店・電子書籍配信サービスが、著作権者からコンテンツ使用許諾を得た正規版配信サービスであることを示す登録商標（登録番号 第６０９１７１３号）です。 ABJマークの詳細、ABJマークを掲示しているサービスの一覧はこちら→https://aebs.or.jp/
Your streamlined Google Docs alternativeExperience fast, effortless collaboration with Stashpad. Get aligned instantly with markdown. No account needed. ... a second brain for busy developers that helps them stay focused and retain those stray thoughts that can add up to something big later on.
最近個人的な日記を書いています メンタルダウンを防ぐためにその日あった良いことを毎日3つ書いているという話を以前ブログに書きました。 この書くという行為、気休めくらいかなと思っていたのですが、自分の頭の中にあるもやもやしたことを書くというのは、吐き出す効果や整理する効果があって、予想以上に効果ありました。 なので今も続けているのですが、最近は、それに加えて簡単な日記を書くようにしています。これが、個人的には良かったので少し紹介したいと思います。 箇条書き日記の書き方 フォーマットとしては以下のようにしています。 日付けと簡単なタイトルをつける（タイトルは省略可） その日あった良いことを3つ書く それ以外の出来事も思うままに書く（イラストつけるとなお良い） 例としてはカバー画像の以下のような感じです。 上の例は、たまたまネットで公開できるような内容ですが、基本的には赤裸々に仕事のこと、感じた
![自分のためだけの箇条書き日記のススメ - karaage. [からあげ]](https://cdn-ak-scissors.b.st-hatena.com/image/square/935dbea9573ae401adc5c450d3485b29c5f579ea/height=288;version=1;width=512/https%3A%2F%2Fcdn-ak.f.st-hatena.com%2Fimages%2Ffotolife%2Fk%2Fkaraage%2F20220514%2F20220514084256.png)
不安や悩みをノートに書き出して、鬱々とした気持ちや頭の混乱をスッキリ整理する――。こうした手法はこれまでジャーナリング、モーニングページ、バレットジャーナル、ブレインダンプ……などとして数多く紹介されてきました。 でも、正しいやり方がわからない、書く時間が取れない、続かないといった声もよく耳にします。そこで、『書く瞑想――1日15分、紙に書き出すと頭と心が整理される』の著者で、5万人以上を変えた習慣化のプロ・古川武士氏が、読者から寄せられた悩みや疑問にお答えしながら、「書く瞑想」のコツについてご紹介していきます。 ● なぜ、書くと気持ちが整理されるのでしょうか？ ［質問］ はじめまして。質問です。ワーキングマザーで、毎日、仕事と育児で忙殺されており、目まぐるしい日々に、気持ちが乱れております。 子どもは可愛いのですが、イライラすることが多く、こころがざわついています。こんな私にも書くことは
「執筆の技術を勉強する会 #2」に参加した #engineers_lt - Really Saying Something
拡散希望！ 明後日2/15に開催する勉強会の告知です。 エンジニアの登壇を応援する会 #engineers_lt で今回執筆をテーマにした勉強会を開催します。技術同人誌を書いてみたい方や、アウトプットの手段として検討してみたいなっていう方は、ぜひご参加ください！https://t.co/dk6xd9gAbt— ariaki (@ariaki4dev) 2024年2月13日 XでYAPCのポストを追いかけていたところに、ariaki（@ariaki4dev）さんのポストが目に飛び込んできて、技術同人誌は作ったことがないものの技術書典に行ったり日記を本にしたりしたことがあった＋YAPCでイベント熱が高まっていたので、半ば衝動的に申し込み、行ってみました。 engineers.connpass.com 執筆の技術を勉強する会 #2 - 資料一覧 - connpass 私はエンジニアではないので（
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい - Qiita
CDの所有欲は低いけど、音源の所有欲は高い派なんだけど
鳥が飛んでるのは空じゃない、と言った友達｜しまだあや（島田彩）
DeepL Write: AI-powered writing companion
Craft – The Future of Documents
Message Passing - はなしをふったりふられたり
Substack - A new economic engine for culture
AIと学生に同じ課題でレポートを書かせるとどうなるか--実験結果が公開
「もの書きのてびき」stoneによる書くことについてのインタビュー集が興味深い。 - 世界のねじを巻くブログ
A privacy-first, open-source knowledge base
英文校正ツールTrinka AI | 無料で添削！論文の英文法チェックに最適
A.口ずさむようにブログが書けない B.ブログになら書けることがある - シロクマの屑籠
みじかい文の連続で文章をかかないといけない理由 | Shiki’s weblog
Stashpad - Your streamlined Google Docs alternative
自分のためだけの箇条書き日記のススメ - karaage. [からあげ]
【習慣化のプロが薦める】簡単なのにメンタルが瞬時に整う奇跡の習慣（ダイヤモンド・オンライン） - Yahoo!ニュース