はてなブックマーク

本記事の要約 ドキュメントを書かない事は、企業やチームの「負債」になる ドキュメントを書かない事は、自身の学びや振り返りの「機会損失」になる そういう文化が根付く前に、負の連鎖を断ち切ろう！ はじめに 世の中のプロジェクトには、ドキュメントが足りていない、と感じています。 でも残念な事に、ドキュメントをどうしても書きたい人は「ほとんどいない」と思います。 その一方で「ドキュメントを書いた方が良い」という事は、 何となく分かっている人も多いと思います。 やりたくない事をやらなければならないのは、嫌ですよね。 そんな気持ちは分かりますが、これを機に一度改めてみませんか。 何故なら、ドキュメントを書かない事はチームに「負債」を生むからです。 勤め人ならば少なからず一度でも、体験した事があると思います。 「どうして必要な過去の資料が無いんだ」って。 あるはずの歴史の一端がソースコードからしか分から

TL;DR トレーシングはデバッグの際にも使える様に環境を整えるべき トレーシングはサービスを構成するプログラムの理解に効果的に使える はじめに 以前自分が体験した話ではありますが、業務範囲が大幅に増えた結果、 まったく知らない業務のソースコードだけを渡され、 読むのに大変苦労した経験があります。 また、私は転職者であり、現職で既に実装済であるサービスについて、 その個々のプログラムの意味や繋がりを理解するのにも苦労しています。 細かい部分に関しては、未だに知らない部分もかなり多くある、と感じています。 まだ理解が足りない、と思う事で感じる焦燥感は、実際に感じる部分がありますし、 逆に受け入れる側としては、物足りなさを感じている部分もきっとあると思います。 まずは、そんな実体験の話をベースに、 この様な問題をどうやって解決出来るか、を提案させて頂きたいと思います。 まったく知らない業務が増

TL;DR 業務フローも良く確認する プログラム開発以外で解決する方法も検討する その方が先を見据えた効率化が進む場合もある 課題 「すみません、毎日行う業務の入力画面を直して欲しいのですが…」 「はい、どの様な改修依頼でしょうか？」 「毎日来る100枚前後の領収書／請求書を入力する画面の修正を…」 というような業務効率化の依頼があったとします。依頼者＝作業者ですね。 今時100枚前後の紙が特定の部署に届くという様な事は無いよ、と思った方は、 恐らくとても良い企業にお勤めです。 こういう事は日常的に行われていたりします。 依頼者の希望通り、画面の構成等を変えることにより、 依頼者は紙から得た情報をコンソール上に入力する作業が軽減される事となり、 一定の作業軽減と、時短による効果を得る事が出来ました。 めでたし、めでたし。 …しかし、この問題は本当に解決したのでしょうか？ 実態 依頼者に具体

TL;DR 本記事は、terraform Advent Calendar 2023 の22日目の記事です。 AWS等の構築を行う際に、何でわざわざterraform(IaC)で構築するんだろう、 めんどくさ！って思う方向けに、わざわざterraformを採用するメリットを挙げて、 開発するモチベーションを高めようというアレです。 terraformでのAWS開発の面倒さ terraformって、面倒臭くないですか？ 面倒くさいですよね。良く分かります。 未だに面倒くさいと思っています。 そんな人と気持ちを分かち合いたい。そして、もっと使いたい。そして伝説へ。 そんな本エントリになっています。 terraform/AWSでの開発手順 プロterraformerな皆様なら分かりませんが、私の様なクソザコterraformerでは、 新しいリソースを新規に作成するケースに於いて、以下の様な手順を