僕は学習をする際には書籍を参考にするのが好きだ。なぜネットとかではなくて書籍を参考にするかというと、書籍のほうが学びたい事柄についてネット情報や人から教わるのと比べて、どちらかというと体系的にまとめられていると思っているためだ。 ただし書籍を参考にしている時によく陥りがちなのが、「学習する」という目的を忘れて、「本を読み切る」という事自体が目的化してしまうことだ。こうならないため、僕はこの書籍を読む目的をはっきり決めるようにしている。その目的が大体3つくらいの種類に分類されてきたので、今回はそれについてまとめてみようと思う。 三つの目的のどれかを選ぶ 僕の中で学習目的で書籍を読むときは以下の三つの目的のどれかに絞っている。 これからの課題を解決する方法を見つけるための読書 これまでうまくいったことの言語化を行うための読書 視野を広げるための読書 この三つのどの目的で本を読むか、自分の中で明

★【勉強法】の本を30冊読むマラソン、今朝の進捗：８冊目読み始めました。これも１度さら〜っと見たまま、メモをとってないので再読です。今度は分厚い本なのだ...。 ★このブログは毎日更新中。平日は朝８時と夜７時、休日は特に時間を決めずに投稿しています。 ★平日は、雑誌で見つけた【勉強法】についての情報をメモ。休日は、【勉強法】の本を30冊読むマラソンのまとめ記事を投稿しています。 ★お知らせ：子育ての本を読む専門のブログを始めました。毎日更新中。子育ての本をたくさん読む！ブログ インテリアや収納の本を読むブログも始めちゃいました！ インテリア・収納の本をたくさん読む！ブログ 今日は午後、仕事がお休みだったので、勢いで始めちゃった！（＾０＾）♪やっぱ、好きなことを書くのは楽しい！！ スポンサーリンク 朝の防水タブレットがあれば、お風呂でリフレッシュしながら情報収集ができる。 - 僭越ながら【1

はじめに エンジニアにとって、仕様書などの技術的な文章を書くこと（テクニカルライティングとも言います）は避けて通れません。ただ20年来多くのエンジニアの方々と同僚として接してきて思うことは、エンジニアの方の中には「文章を書く」ということに苦手意識がある方が一定数いるということです。 でもこの「テクニカルライティング」のスキルは、才能というよりは一種の「技能」だと思うんです。ある一定の原理原則を理解して実践を繰り返すことで、必ず一定レベルで習得できるものだと著者は信じています。 もしこのテクニカルライティングの原理原則をまだ体系的に学習したことがない、または過去学習したが改めて再学習したいという方に、お勧めのコンテンツを見つけたのでご紹介します。 https://developers.google.com/tech-writing Every engineer is also a write

西村マサヤ @masayaquality 今日、違う部署の新卒から「わかりやすい文章を書く方法を教えて欲しい」と言われたので、このリストを送ったのだけど、ほんとこの20個意識するだけでだいぶ変わると思うな。 新卒や学生はぜひ実践してみてほしい。 pic.twitter.com/JrUgbpmD53 2020-05-26 22:50:51

以前社内に書いたポエムなんだけど年に1回くらい引用したくなるので公開した tl;dr; 質問をする時はゴールを提示する【MUST】 理由1 理由2 コンテキストを詳しく共有する【SHOULD】 期待してた結果(expect)と実際の結果(actual)を書く【IMO】 2020/7/22 12:30追記 2020/7/22 19:00追記 tl;dr; テンプレ 【質問内容】 【やりたいこと or 今困ってること or 質問の意図】 質問をする時はゴールを提示する【MUST】 なにかやりたい けど実現できない、うまくいかない それで質問する って感じに、質問をする動機としてまず やりたいことありき のはずなので、それを提示すべきです 理由1 質問される側（以下回答者）は質問内容がふわっとしていると色々なケースを想定して回答を組み立てます *1 例「Aの場合は～だけど、Bの場合は～」 こうい

すごいタイミングですごい本が出たもんだ。 本日はKubernetes Advent Calendar 2020 その1 向けのエントリー。 本当はCF for k8sの記事を書くつもりだったのだけど、先週盛り上がりまくったDockershimのDeprecated話の後ですごーく良い本が出てきたので、これは紹介せねばということで急遽内容を変更。 jaco.udcp.info CF for k8sの話も途中まで書いちゃっているのでまた日を改めて公開する。 あの神資料が本になったよ ということで今日の話題はこちら。 イラストでわかるDockerとKubernetes Software Design plus 作者:徳永 航平発売日: 2020/12/05メディア: Kindle版 今ではDockerやKubernetesに関する本もだいぶ出揃い、使い方を学ぶのには困らなくなってきた。それに、基

いまちょうど『文章力が、最強の武器である。』という本を読み終えたところです。 これで、ついに出そろいました。 長らく追い求めていた「文章力」の理想郷。 どうやらそこには、4人（冊）の四天王がいらっしゃったようです。 これまで「文章力」「文章術」「書き方」と検索して、約20冊近く読んできました。 その中から選び抜かれた四天王をご紹介します。 入門編『文章力が、最強の武器である。』藤吉 豊 https://amzn.to/3njBbiF 最初に四天王の1人目、入門編で待ち構えているのがこの『文章力が、最強の武器である。』。 まず何と言っても、章立てがすごく魅力的なんですよね。 第1章は、文章力が劇的に上がる「3つの視点」。 おもしろい わかりやすい 読みやすい この3拍子が揃った文章こそが、「良い文章」なのだと筆者は語っています。 その後、先ほどの3拍子それぞれを伸ばしていくための考え方・型・

howto-tech-docs.md 技術文書の書き方 このメモは、私（@ymmt2005）が長年にわたってソフトウェアプロダクト開発に関わってきて 2022年現在こうしたほうが良いと考えているベストプラクティスです。 科学的な分析等に基づくわけではない経験則であるため、今後も随時見直すことがありますし、 ここに書いてあることが常に正しいわけでもあらゆるソフトウェア開発に適するわけでもありません。 しかしながら、実務経験が豊富で、モダンな技術スタックに明るいエンジニアの経験則は一定の 役に立つのではないかと考えて記します。 技術文書とは ここでは、ソフトウェア開発で技術者が書くべき文書ということにします。 ソフトウェアエンジニアにも役割がいろいろあり、アーキテクトと independent contributor では書く文書が違うということはあるでしょうけれど、ここではごっちゃにします。