大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？ 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体

テクニカルライティングの基本を学べます。サイボウズの新入社員向け研修資料です。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 Twitter：https://twitter.com/naoh_nak 2023年度のアップデート版もあります：https://speakerdeck.com/naohiro_nakata/technicalwriting2023

「もっと話上手になれたらいいのに」と思っている人は多いのではないでしょうか。 普通のビジネスパーソンは、アナウンサーのような卓越した話術を身に付ける必要はありません。しかし、話上手になることができれば、交渉が得意になり、営業も人事評価も転職活動も有利に進められるようになります。仕事におけるメリットは計り知れません。 私たちの会社でも、特に顧客と直接対話する機会が多いディレクターやデザイナーには、業務知識だけではなく、顧客との話し方についてもなるべくフィードバックしています。会話のクオリティは、サービスの品質や満足度に深く関わると思うからです。 最近は、会話ではなく、メールやチャットで済む機会も増えています。一方で、話上手な人はテキスト・コミュニケーションも大抵上手な印象があります。話術の中には、コミュニケーションに共通する普遍的ななにかが含まれているのでしょう。 こんな記事を書いてはいます

(This post is also available in English.) この記事は Linux memory management at scale を 著者の Chris Down さんの許可 を得て Hiroaki Nakamura が日本語に翻訳したものです。 原文のライセンス は CC BY-SA 4.0 であり、翻訳のライセンスも同じく CC BY 4.0 とします。 cgroup2 プロジェクトでの私の仕事の一部として Linux システムのリソース管理についてエンジニアと話すことに多くの時間をかけてきました。 これらの会話を通じてどんどん明らかになってきた 1 つの事実は多くのエンジニアは、シニア SRE たちでさえも、 Linux のメモリ管理についていくつかのよくある誤解を持っていて、そしてそれが彼らがサポートするサービスやシステムが本来確実に稼働したり効率的

大嶋信頼 さん著書の「片づけられない自分がいますぐ変わる本」を読みました(o^^o)📚 心理カウンセラーの著者さんが、『片づけられない自分がいますぐ変わる本』と題して、 心理学に基づく”部屋”と”心”が整う片づけメソッドを解説してくださる一冊です。 毎日がラクになる25の整理術。片づけなきゃ！を捨てることからはじめよう！ 片づけなきゃ！ 気合いを入れるほど、気合いが抜けていきませんか？ 本書は、片づけがうまくできない原因を心理学をベースに紐解きながら、 片づけが楽しくなり、片づいた状態が気持ちいい！と感じられる片づけメソッドが書かれています。 片づけられるようになるには、片づけようという気持ちをまず捨てること。 ここが、とても印象的な一冊です。 片づけようとおもうのに、片づけられない。 片づけなさい！といわれるほど、意欲がなくなる。 いま現在だけでなく、こどものときを振り返っても覚

【要約】 最高の英単語帳を見つけました。 しかもなんと、その英単語帳は『無料』です。 このnoteでは、その画期的な英単語帳の紹介と、英単語帳のデータを無料配布します。 【更新履歴】 22/08/19: ・8000件を超える改善を行いました。 ・改善をリアルタイムで配布データに反映できるように、データのダウンロード方法を変更しました。 21/12/09： ・iOS/Android版アプリをリリースしました。 科学者がつくった最高に怠惰な英単語帳「これだけ覚えておけば英語が読めるようになる英単語帳とかないかなぁ〜〜」 なんて考えたことありませんか？ わたしはわりとあります。 プログラミングを始めてからは、英語に触れる機会が格段に増えたこともあり、わたしの中でこのニーズはますます強くなっています。 しかし、わたしは怠惰です。 できることなら、最小限の努力で英語を身に付けたい。 そこでわたしは、

はじめに 株式会社デジサク がお送りするプログラミング記事、 今回は要件定義・システム設計について扱っていこうと思います。 プログラミングを勉強していて、こんな事を感じた経験はないでしょうか。 「勉強してもプロダクトが作れない」 「そもそも開発ってどうやるの？」 「要件定義ってなに？」 その悩みを解決するために、まずは開発の全体感を理解しましょう。 下図『ソフトウェア開発プロセス』をご覧ください いつも勉強しているプログラミングは 『実装』 の部分に該当します。 つまり、プログラミングの実力を発揮する前に４つも壁が存在するのです。 そのため、本記事では実装（プログラミング）を開始する前に必要となる、 『企画～設計』 について順を追って説明して行きます。 特に、エンジニアが理解しておくべき 『要件定義』『設計』 にフォーカスします。 なお、開発全体において実装（プログラミング）に使用する時間

リンク Wikipedia 麻雀 麻雀（マージャン、繁体字: 麻將、簡体字: 麻将、英語: Mahjong）とは、テーブルゲームの一種である。牌を使い、原則として4人で行われる。中国を起源とし、世界中で親しまれている。 4人のプレイヤーがテーブルを囲み136枚あまりの牌を引いて役を揃えることを数回行い、得点を重ねていくゲーム。勝敗はゲーム終了時における得点の多寡と順位で決定される。ゲームのルールは非常に複雑であるが発祥の地である中国のほか、日本、アメリカ合衆国などの国々で親しまれている。 現在の中国語においては麻雀のことを一般に「麻将」（ 31 users 86

【保存版】立ち食いそば屋195店を回った男が選ぶ「2019年そばベスト7」 立ち食いそば放浪記まとめ 中澤星児 2019年12月28日 2019年ももうすぐ終わり。年号が令和になった今年は変化の年と呼べるかもしれない。古いものが終わり、新しいものが産声を上げるサイクル。一方で、私（中澤）が平成から続けているものがある。 うまいそば屋を求めて色んな街を放浪する「立ち食いそば放浪記」だ。2015年から開始して第195回を数えるこの連載。今年レポートした店を数えてみたところ58店だった。話題の店から変わり種まで放浪した2019年。その中から独断と偏見で選ぶベスト7をここに発表したい。 ・第7位『さ竹』恵比寿

アメ横がダメになってきたというブログ上がってたけど、そんなことは”全く”ない。 プロの料理家だけど、アメ横への買出し�隔週で１回位行ってる。 アメ横は絶対に買ってはダメなものと、ここでしか手に入らないものが混在した日本の中のアジアなんだよ。 年末買出しに行く人とかもいると思うので、アメ横の攻略法を書いてみる。 ＜最重要事項＞ ○絶対に魚介類をアメ横の路面店で買ってはダメ さすがにこれは有名になってきたが、最重要事項なので改めて。 アメ横の路面の叩き売りの魚介は解凍→冷凍→解凍を繰り返した超粗悪品。 下手すると腐ってて生食すると食中毒レベルのものも混ざってる。 絶対に買ってはいけない。これだけは守ってくれ。約束だぞ！ ＜初級編＞ ○魚介が欲しかったら、御徒町駅前のスーパー「吉池」へ （訂正；ここは新潟県の寺泊から進出したスーパー　→　ごめん！角上とごっちゃになってました。吉池は新潟県十日町の

あぢーー。なんともたまらない日が続いていますね。 そんな時にはやはりかき氷。口に運ぶごとに涼しさで満たされ、食べ終わる頃には体感気温もぐっと下がっているものです。 中でも筆者が大好きなのは、レトロ風情な店内でいただくやさしいお味の一杯です。昭和から時が止まったようなお店で平日の昼間からかき氷をバクつけば、自分ダメだなー……と思いつつ、うっとり。今回はそんなかき氷がいただける大阪の名店から、厳選して5店ご紹介させていただきます！ 1つめ：「角屋」の抹茶系かき氷 「角屋」のポイント とにかく安い。ほとんどの商品がワンコイン以下 宇治抹茶を使用した抹茶系かき氷が至高 70円のアイスモナカが、これまたいい 大阪・旭区にある千林商店街を、少しそれた辺りに位置する甘味処「角屋」。 アイスモナカを中心に、冬場は回転焼き（関東でいうところの今川焼き・大判焼き）、夏場はかき氷を提供しています。 壁にずらりと

都内・近郊にあるアジアンフードの「本場」といえば、横浜中華街と新大久保コリアタウン。ところが近年、「第二の本場」が各地で生まれているというのです。今回はその中から、赤坂の韓国料理、西川口の中華料理、小岩のタイ料理にクローズアップしてグルメマップをつくってみました。 1.【韓国料理】 プロカンジャンケジャン ソウルに本店を構えるこのお店は、ケジャン一筋40年。ケジャンとは、ワタリガニをタレに漬けて熟成させた料理です。とにかく味わってほしいのは、店舗名にもなっている「カンジャンケジャン」（4,280円）。かに味噌と卵が詰まった韓国産ワタリガニを醤油ダレに漬けることで、素材の旨みと甘さが引き出されたご飯が進む逸品です。これを目当てに、韓流スターたちも来日時に訪れるのだとか。専門店ならではの本物の味をどうぞ。 店名 プロカンジャンケジャン 電話番号 03-3588-8778 アクセス 東京メトロ銀

こんにちは。たこ焼き神（たこやきしん）です。 いきなり現れた、つけ麺屋のおっさんみたいな恰好をした豚が「たこ焼き神」を名乗ったところで、「たこ焼き神って、なに？」って言われると思うので説明しますね。 たこ焼きの、神です。 というわけで改めてこんにちは。たこ焼き神のヨッピーです。 普段から僕は「銭湯神」とか「鼻炎王」とか、何の根拠もなくえらそうな肩書きを名乗るのが大好きなのですが、実はこの、「たこ焼き神」という肩書きに関してはちゃんと根拠があります。 例えば僕が過去に書いたたこ焼きの記事、 r.gnavi.co.jp これがGoogle検索において「大阪　たこ焼き」で1位の位置に掲載されているからであります。どう？すごくない？ ちなみに「東京　たこ焼き」でも僕の記事が2位に来ます。 これはもう「たこ焼き神」を名乗っても完全に許されるのではないでしょうか。え？許されない？そうなの？なんかみんな

こんにちは、ライターの玉置です。家庭用製麺機愛好家として、製麺同人誌の製作や製麺の普及活動もしています。 https://soredoko.jp/entry/2017/12/15/110000 突然ですが質問です。ピザは好きですか？ ピッツァでもいいです。 まず私から答えさせていただきますと、最近までは「普通に好き」という感じでした。そう、最近までは。 ピザといえば、子供の頃はトースターで温めるチルドタイプの安いもの（ビニールに包まれている生地の厚いやつ）を喜んで食べてましたが、大人になると年に数回、出前のピザを食べる機会がある程度（自分で頼んだことはない）。あとはファミレスとかで食べるくらい。 特別な思い入れはないけれど、あればうれしいという存在。それが私にとってのピザだったのです。 そんな私でしたが、友達に勧められて「さくさく石窯ピザメーカー」というピザ専用調理家電を買ってから、ピザに

はじめに 本稿では、仕事をする上での作業工数の見積もり方法について説明します。 工数とは何か 工数(こうすう1)というのは、仕事において、あるひとつの作業を完了するまでにかかる総累計時間のことです。情報処理技術者試験に出てくるTAT(ターンアラウンドタイム)とは意味合いが異なります2。 例えば、ある作業に40時間(40H3)かかるとした場合、工数は40時間であるといえます。1日8時間勤務だとした場合、40時間は5人日(にんにち)と表現することができます。さらに、1ヶ月20日勤務だとした場合、0.25人月(にんげつ)と表現することもできます。 一般的に工数の単位は「人日」および「人月」で扱います。 学生時代は工数を気にすることはないですが、ITエンジニアとして会社で働くようになると、かならず工数を意識する必要があります。 なぜ工数を意識する必要があるのか なぜ工数を意識する必要があるのかとい

僕のことを直接しっている人にはよく知られた話ですが、僕はなかなかどうして話すのがヘタでして、コミュニケーションをとるのが得意ではないのですね。 特に、大人数の前だとすごい緊張しちゃうので、落ち着いて話すこともできません。心臓がバクバクいい、足が震えます。10人以上いる会議で発言とかかなりキツイです。 で、そんな僕なんですが、プレゼンをしなさい、となる時もたまにあって、そういう時、結構困るのですね。どうしたらいいんだと。 しかし、何回か回を重ねていくことで、話す技術を向上することはできなくても、表面的なテクニックでなんとかカバーすることは出来るな、と思ってきました。ハウツーですね。僕はハウツーが好きなんです。 そのあたりのテクニックをたまに後輩に教えたりするのですが、ブログにまとまっているほうがいいかなと思ったので、紹介します。 ---✂--- 「遊び半分の起業のすすめ」 最近、こんな感じ

ビジネス系のサイトをはじめ、ランディングページ、ポートフォリオ、もちろん個人ブログにもぴったりなイラストのSVG素材が無料でダウンロードできるサイトを紹介します。 シンプルでセンスのあるイラストが揃っており、しかもクレジット表記不要の太っ腹ライセンスなので、使い勝手がよいと思います。 unDraw unDrawの特徴 イラストのSVG素材 素材のダウンロード unDrawの特徴 unDrawではランディングページ、スマホアプリ、プロダクトなどで利用できるイラストのSVG素材が無料でダウンロードできます。 イラストのフォーマットは、SVGと透過PNG イラストのテーマカラーは変更可能 MITライセンスで、使用時のクレジット表記は不要 テーマカラーの変更は、オンラインで簡単にできます。SVGだけでなく、PNGにも対応しています。

vim以外のエディタでコード書くと私の手は産まれたての子鹿みたいになります。 効率よくコーディングをしてもらうために、新人やvimを学びたい人にvimの研修を実施しています。今回は研修で非常に有効だった内容についてまとめておきます。 ※ なんだか誤解を生んでしまっているようなので追記しておきます。vimの研修は新人研修の一環として行ったわけではなく、vimを使って開発をしたがっていた新人へテスト駆動開発の研修を実施した際に並行して盛り込んだだけです。会社がvim強制とかではないのでご安心ください。言葉足らずで申し訳ありません。 2つの繰り返しキーの存在を認識させる vimは一度実行したコマンドの組み合わせを記憶する.(ドット)とfを使った移動の際のキーストロークを記憶しておく;(セミコロン)があります。これらを駆使することで他のエディタよりも高速な編集作業を行えます。 セミコロンはus配列

不動産投資に興味があるけど何から始めていいか分からない…営業マンのいうことを鵜呑みにして失敗したくない…しっかりと基礎から学び、できる限りリスクを避けたい… （１）老後資金のための制度個人型確定拠出年金（iDeCo）とは、個人が運用方法や掛け金を自分で決めることができる年金制度のことです。 アメリカで401kという名前で始まった制度の日本版で、これまで公的年金に大きく依存していた老後資金について、ある程度自分の裁量や判断によって選択できるようになったことが最大の特徴です。 しかも個人型確定拠出年金（iDeCo）には3つも魅力的な税制優遇があるので、その節税メリットと運用益が重なることでより多くの老後資金を用意することができます。 （２）公的年金との違い公的年金は国が主体となって半ば強制的に行っている制度です。年金加入者が年金の運用方法に口出しをすることはできず、同じ属性の人であれば受け取る