2:29Published2021/12/31Tags2021ReviewURL(順不同)最後までやり切ること取締役だった会社をクビになり、惨めに追い出されたときの思い出。昔、ある会社をクビになって惨めに追い出されたことがある。当時の私のポジションは、持ち株ほぼ0の雇われ取締役。言って頂き、就いたポジションだった。さまざまな施策を講じたが、最終的に自力再建に至らず他社の傘下に入るイグジットを選択することになる。社内で文書の質が高いと評価してもらえるまでにはなった。して、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。皆さんが「ドキュメント」と聞いて一番に思い浮かぶものは一番最後の例(4.)だろう。各種サービスやソフトウェアにはこうしたドキュメントは必須だ。技術を実際に使えるものにしていくにあたって、それはどちらかというと最後のフェーズ(および運用フェーズ)で高い価値を発揮するものである。自分たち一介の技術者(開発者)にとっては、そのフェーズに持っていくまでをどうするかの方が日々の仕事では大きなウェイトを占めているのではないだろうか(少なくとも僕の場合はそう)。当てはめることはできるはずだ。この一文に大体このエントリで伝えたいことが集約できている。質の高い技術文書とは、誰が読んでもハッキリとした輪郭で必要十分な情報が伝わるものである。様な文書をどのように使うかだが、基本的には頭から読んでもらって、議論をしたのちに次のアクションを決める、といった形になる。分程読んだ後に議論を始める、というのがよく語られているが、僕が所属するチームでは大概のミーティングでまさにそれをやっている。質の高い文書は上に書いた様にアウトプットが明確で、読み手全員に一定に伝わるので、全員のレベルを短時間で揃えた上で議論を開始できるため非常に効率が良い。してもらうことが目標になるので、文書として見ると気をつけるべきことは大体同じだ。入る前はあまりこういう形で文書を使ってこなかったけれども、今ではこの手法なしに仕事を進められる気がしない。質の高い文書を書くコツのまず第一であり最も重要なことは、最初にアウトプットを定めることである。backwards"そのものだ。TopicでNFTについて話したのは3月の記事で、その時はNFTの説明と何故NFTがデジタルコレクタブルなのかを解説しました。そこから1〜2ヶ月間、NFTバブルは続いたが、5月〜6月頃に取引額が下がったと報道されたり、NFTに対する熱意が下がったように見えた。(fladdict)|note仕事では日々の忙しさに追われ、根本的な問題解決に手が回らないことがよくあります。やらなきゃいけない大切なことがある。日々の業務が忙しくて着手できない...このような問題を『のジレンマ』と呼びます。中長期で考えれば、未来への投資をするほうが正しいのに、短期視点では現在の作業に全リソースを投入せざるをえない。いわゆるパラドックスの一種ですね。...https://note.com/fladdict/n/n14d18afc14ed理想、単純な憧れ生涯現役のソフトウェアエンジニアでありたい。ファインディエンジニアラボソフトウェアエンジニアの藤吾郎と申します。いう言葉でキャリアが語られることも増えてきたように思います。この記事では、ソフトウェアエンジニアにおけるICというキャリアパスについて、自分の認識と経験を交えて次の点から解説していきます。blog周りを見ていると何の苦もなく英語社会に適応しているわけですが、日々苦しんでいる人の奮闘記があっても良いのではないかと思って書きました。残念なエピソードを晒すことで実は自分もこうやって乗り切ってましたという人が現れお互いに助け合えることを期待しています。ファインディエンジニアラボサムネイルは筆者が住むイスラエルの写真。...https://engineer-lab.findy-code.io/trivy-fukudaこの連載に勇気をもらえた白山文彦について|父|note初めてnoteで記事を書くので、手習いとして自己紹介したいと思う。最新の情報は常にLinkedInにある。