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

本の学びを深めるオンライン講座「flier book camp」を運営する株式会社フライヤーが主催したイベントに、ゲストとして登場したのは、『無敗営業』シリーズ著者の高橋浩一氏。今回はファシリテーターにフライヤーアドバイザー荒木博行氏を招き、「言える・伝わる・あのひとが動く『伝え方の原則』」をテーマに対談します。高橋氏は、相手にうまく動いてもらえない時は“地雷”を踏んでいる場合が多いのだと語り、気持ちよく人を動かすための「伝え方」のポイントを解説しました。 相手にうまく動いてもらえない時は“地雷”を踏んでいる 荒木博行氏（以下、荒木）：浩一さんはものすごく大量にいろんな人の営業トークやコミュニケーションの現場に立ち会われていて、ロールプレイもかなりやってらっしゃると思うし、そこでのフィードバックもけっこうされているわけですよね。 「やっぱりここでコミュニケーションが躓いちゃうのか」というも

なんでかわからないのだけれど、いつも「ここにいちゃいけない」気がする。 本当は私はここにいてはいけないし、みんな早く出ていかないかなあと思っているのだけれど、まあなんか色々理由があってどうにかここにいさせてもらっている気がする。 職場は「上司が採用しちゃったから仕方なく」「辞めさせたら自分の仕事が増えるから仕方なく」ここにいさせてもらっている気がする。 スーパーやコンビニは「買い物客だから」いてもいいのだと思う。 自宅は、賃貸に一人暮らしなんだけど、「家賃を払っているから」部屋の中にいていいのだと思う。 常に強くここにいちゃいけないと思っているわけでもない。 でも、疲れているのかなんなのか、調子が悪い時は自宅だって「家賃払ってるし、入居規則だって守っている。例えば騒音も出してないんだから、ここに居ていいはず！」と金銭と契約を引き合いに出さないと自分がそこに居ていい自信が持てない。 子供の頃

勉強してもすぐ忘れてしまう。思ったような成果が出ない……。その原因は、勉強後の「復習」や「振り返り」が不足していることにあるのかも。 記憶定着のためにも勉強効率アップのためにも重要な振り返りを、あなたはサボってはいませんか？　「自分もそうかも……」という方は、ぜひ以下のチャートで自分に合った振り返り法を診断してみましょう。 なかには、勉強法そのものを改善することで、より振り返りがしやすくなる人もいるかもしれません。 みなさんにピッタリなのは、どの振り返り法でしたか？　それではひとつずつ、詳しいやり方を具体例とともにご紹介しましょう。 1. 記憶出し入れ法 2. イルカの暗記シート 3. コーネル式ノート 4. 間違いノート 1. 記憶出し入れ法 「振り返りのための時間は少ししかとれない」人で「紙」を使って復習したいタイプの人におすすめなのが、「記憶出し入れ法」。 これは、勉強内容の振り返り

私自身、物事を分かりやすく伝えるスキルを身に着けるため、手あたり次第に、いくつかノウハウ本を読んだり、YouTube動画を観たりしてきました。本記事では、本や動画から得られたノウハウや、私が普段の仕事で発見した個人的に使っているテクニックをまとめてみました。 0 本記事の最重要ポイント 本記事がストックの墓場に行ってもいいように、本記事の最重要ポイントだけ先に伝えておきます。 質問に答える時は、聞かれたことにシンプルに答える。 事実と解釈を分けて話す。 1 本記事で伝えたいメッセージ 1-1 コミュニケーション能力の苦手意識はノウハウで解決する ITエンジニアの裾野が広がるにつれて、SNSでも「コミュニケーション能力の低いITエンジニア」の話題をちらほら見かけるようになりました。いわく「これからはITエンジニアにもコミュニケーション能力が求められる」「プログラミングができるだけでは生き残れ

クイーンズランド大学が開発したHIITがすごい。HIIT WBというエクササイズで、たった4分間の運動で30分の有酸素運動を遥かに凌ぐ効果を発揮する。心肺機能と筋肉量の増加、脂肪減まで期待でき、抗老化に繋がる。動画をそのまま真似し… https://t.co/FWvRp0RAaR

2022-08-08 リーダーの作法 ささいなことをていねいにを読み終えた。 著者は Netscape でマネージャー、Apple でディレクター、Slack でエグゼクティブを経験した Michael Lopp さんで、過去にBeing Geek や Managing Humans を書かれている。 翻訳の質も非常に高く、楽しく読めた。1 そんなにマネジメント関係を読んでいるわけではないが、HITH OUTPUT MANAGEMENT や、エンジニアのためのマネジメントキャリアパス ―テックリードから CTO までマネジメントスキル向上ガイド 同じくらい良い書籍で、学びや共感を多く感じた。 自分はマネジメントのポジションについたことはないが、仕事をしていくなかでマネジメント関係のソフトスキルや複数人でどうやってうまくリーダシップを発揮して、大きい問題を解決するかに興味があるので、良い書籍

はじめに議事録、取ってるぅ？ そろそろ新人は現場に配属され始めた頃だろうか。 「議事録取っといてよ」とか軽く言われて頑張って作ったら、赤字まみれに添削されるのが通過儀礼。 だいたい新人が最初に任される仕事だと思う。 ところが、議事録を真っ当に取ろうとすると日本語能力、プロジェクトへの理解、構造化力とかが試されるので、割と高度なスキルの複合が求められるのである。 というわけで、議事録を簡単に作るコツを１つ伝授したい。もちろん、習得のためには訓練が必要なので、この記事ではTips程度の話だけど、結構便利だと思う。 実用系スキルなので最後に課金枠を作っておくが、課金枠に中身はない。 君はおひねりを落としてもいいし、落とさなくてもいい。 そもそも議事録とは議事録とは、議事を記録したものである。 一般に会議を行った際の議論の展開と結果を示すもので、発言を一字一句名前付きで記録するものは特に逐語録なん

無料 BGM・効果音のフリー音源素材 誰でも 報告不要で 商用利用無料！ 今すぐ使える BGM・効果音 1,000点以上！ 動画制作やイベントに もちろんスプリンギン アプリでも利用可

「いくらアイデアを出しても、使えるものが見つからない……」 「このアイデアを、取引先におもしろいと思ってもらえるだろうか……」 このように悩んでしまうのは、アイデアの質を、いまひとつ高めることができていないから。 とはいえ、アイデアの質が高まらないのは、そうするための方法を単に知らないだけの話かもしれません。その方法とは、「トリーズの9画面法」。今回は、よりよいアイデアを生むのに役立つトリーズの9画面法のやり方を、筆者の実践例もあわせてご紹介しましょう。 アイデアの質が低い理由 1. アイデアの3要素がそろっていないから 2.「ベストなアイデア」でなければ意味がないと考えているから 「トリーズの9画面法」とは 「トリーズの9画面法」を活用するメリット 「トリーズの9画面法」を実践してみた 実践してみたら、アイデアをよりよくすることができた！ 素朴なアイデアの質を簡単に高められる 勉強でも「

質問（簡単に教えてもらおうとする相手にイライラするようになった） あなたのおっしゃる「質問されるとイライラする感じ」はよく理解できますし、同じように感じる人はたいへん多いと思います。（続く） #結城浩に聞いてみよう… https://t.co/CKZMzVzHPN

つい最近、「人の話をちゃんと聞けない人」を「聞ける人」に変えるのは可能なのか、という話でディスカッションになった。 というのも、ある経営者が「お客さんの話を全く聞けないメンバーがいる」と愚痴をこぼしたからだ。 すると、周りの人々も、呼応するように、「いるいる」という。 その経営者の話を聞くと、おおむね次のような状況だった。 その人は、良く言われるテクニック的な「傾聴する姿勢を見せる」のは得意だという。 「聞き上手」のように、メモを取ったり、頷いたり、相槌を打ったりする。 人の話を遮ったりもしない。 しかし、同僚やクライアントからしばしば、次のようにクレームがあるという。 「あの人、全然話を聞いてないんだよね。」と。 具体的にはどのような事象でしょう？と聞くと、 「例えば、同僚から意見を求められても、「それでいいと思います」としか言えない。あるいは、クライアントが「この構成に対して指摘はあり

「日本のエンジニアは不足しているというけれど本当？　その原因は？」 「わが社でもエンジニアが不足していて困っている、何かよい解決法はないか？」 いまこの記事を読んでいる方は、そのような疑問や悩みを持っているのではないでしょうか？ 「エンジニア不足というのはウソだ」と主張する向きもありますが、実際にデータを見ると確実にエンジニアは不足しています。 2018年時点の調査で22万人、このままいけば最悪の場合は2030年時点で79万人が不足すると予想されているのです。 原因として考えられるのは以下のようなことです。 ・IT市場が急成長している ・技術革新のスピードが速い ・エンジニアの高齢化が進んでいる ・IT業界の労働環境がよくない そして、この解決のために企業がとれる対策としては、以下が挙げられます。 ・エンジニアの待遇を改善する ・社内で人材を育成する ・海外人材を活用する そこでこの記事で

今、IT関連の技術は様々な企業の競争力の源泉です。一方で、実際に企業が必要とするよりもITエンジニアの数は少ないため、採用競争は激化するばかりです。そこで、元ウェブエンジニアでITエンジニアの採用担当を経験した私の視点で、ITエンジニア採用に関する情報をまとめることにしました。 なお、ここでいうITエンジニアはアプリケーションエンジニア、インフラエンジニア、機械学習エンジニア、QAエンジニアなどIT関連エンジニア全般を指します。 # 更新情報 * 2022/05/17 - 公開 * 2022/05/17 - 中途採用前提であることを Chapter 1 に追記 * 2022/05/18 - 誤字の修正 Chapter 15 「行進」 -> 「更新」 ※はてなブックマークでの指摘ありがとうございます * 2022/05/19 - 活用事例の Chapter を追加 * 2022/05/20

娘のことを大事に思っているのに、なぜか娘との会話がぎくしゃくしたり、煙たがられたりしている。そんな父親に対して、脳の仕組みをベースにしたコミュニケーション方法を説く、人工知能研究者・黒川伊保子さんの著書『娘のトリセツ』から、娘や家族とのコミュニケーションを円滑にするコツをご紹介します。 文・黒川伊保子 コミュニケーションには法則がある 先日、セミナー後の質疑応答で、ある男性から質問を受けた。 「女性はなぜ、質問にまっすぐ答えないのでしょうか」 ――この間、家に帰ったら、妻が見慣れないスカートをはいていた。新しいのかなぁと思って、「それ、いつ買ったの？」と聞いたら、妻がむっとしたように「安かったから」と答えた。うちではよくある展開で、質問への答えが永久に返ってこないし、会話も弾まない。あれは、どうしたことでしょうか。 あらまぁ、と、私は声を上げそうになった。重要なコミュニケーションの法則を、

「Amazon Aurora Serverless V2」正式版に。瞬時にスケールして数十万トランザクションに対応、データベース容量も自動管理 Amazon Web Services（AWS）は、クラウド上でデータベースのマネージドサービスとして提供している「Amazon Aurora Serverless」の新バージョン「Amazon Aurora Serverless V2」の正式版としてのリリースを発表しました。 Instant scale ↔️ instant cost efficiency. Amazon Aurora Serverless v2 scales in a fraction of a second while eliminating database capacity management, so you only pay for what you use & sa

立憲民主党の泉代表は石川県小松市で街頭演説し「この30年間、ほとんど自民党が政権を担っていたが、子育て支援政策が不十分だった」と批判したうえで、公立の小中学校の給食費や高校の授業料の無償化などの支援策が必要だという考えを示しました。 この中で、立憲民主党の泉代表は「この30年間、ほとんどすべての期間を自民党が政権を担っていたが、どうなったのかをよく認識しなければいけない。子育て支援政策が不十分で、若い世代の収入や暮らしが不安定になってしまっている」と批判しました。 そのうえで泉氏は「『非正規雇用での子育ては大変だから、もうやめておいたほうがいい』『子どもを育てるのは大変だ』という声が広がってしまうと『やっぱり子どもを産むのをやめようか』という空気が出てきてしまう。公立の小中学校の給食費や高校の授業料の無償化、大学に行って卒業したときに借金をしなくてもいいような子育て支援政策をやっていかない

こんにちは、リファクタリングが大好きなミノ駆動です。 これは、私が執筆した『良いコード/悪いコードで学ぶ設計入門 ―保守しやすい 成長し続けるコードの書き方』について紹介する記事です。 2022年4月30日発売です（ほぼ同日に電子書籍版も出ます）。 AmazonなどECサイトで、すでに多くの予約が入っており、ヨドバシ.comでは一時期予約終了になったほどです。おかげさまで初版部数が2倍になりました。 ■どんな本？皆さんはプログラミングでバグを埋め込みたいですか？ロジック修正が上手くいかず、ヒィヒィ言いながら長時間残業したいですか？イヤに決まってますよね。ところが現実には、 何度もバグを埋め込んでしまう ロジックを読み解くのに時間がかかる やっとロジック修正しても、全然違う箇所がバグ化してしまう ……ほとんど誰もが体験しているのではないでしょうか。 でも、こうした状況をなんとかしたいと思って

PHPerkaigi 2022 Day2 Track B