msksgm’s blog

msksgm’s blog

Webエンジニアです。日々の勉強記録、技術書感想、美術観賞感想を投稿します。

2024年3月の目標

概要

2024 年 3 月の目標です。

勉強関連

SRE・DevOps、Kotlin、英語を対象に OKR を実施しています。

1 月〜3 月の目標

1 月〜3 月を終えた時点での目標は下記です。

注力分野 Objective(3 ヵ月経過後の目標) Key Result(必要だと考えていること)
SRE・DevOps SRE の考え方を学ぶのはいったん完了とする。スクラムによって仮説検証を回すプロセスを体験する 書籍ベースの SRE の学習にひと区切終える。スクラム開発を実践する。
Kotlin 自身の Kotlin の知識を把握して、新しい知識を拡充する 自身が作成した書籍の更新。公式ドキュメントを読む
英語 英語で技術系のコンテンツをなんとなく読めるようになる 基本的な英語の知識から始めて、3 月には技術系記事に対してやってみる

3 月の目標

それを達成するための 3 月の目標は以下になります。

注力分野 Objective(1 ヵ月度ごとの目標) Key Result(具体的な行動予定)
SRE・DevOps 書籍ベースで、SRE に区切りをつける。業務でスクラムを再度実践する SRE 関連の業務に携わる機会があるので、現状の整理と目標設定を実施する
Kotlin LT で発表する。Arrow のコードリーディングする サーバーサイド Kotlin LT 大会 vol.11で発表する。Arrow のコードリーディングの計画を立てる
英語 英語学習を継続している 2 月に決めた勉強内容で実践する

読書

OKR の本では下記の本を読みます。

2024年2月の振り返り

概要

2024 年 2 月の振り返りです。

勉強概要

今月は下表のように勉強していました。 合計、約103.98時間です。 月末には引越しの準備があったので、時間が確保できませんでした。 生活リズムもかわるので、体調面にも気を付けながら取り組みます。

項目 1 週目(2 月 1 日〜2 月 4 日) 2 週目 3 週目 4 週目 5 週目
平日朝の勉強時間 約 8.33 時間 約 17.1 時間(41 ポモドーロ) 約 10.4 時間(25 ポモドーロ) 約 4.58 時間(11 ポモドーロ) 約 4.58 時間(11 ポモドーロ)
平日夕方の勉強時間 約 1.25 時間 約 1.25 時間(3 ポモドーロ) 約 0.417 時間(1 ポモドーロ) 約 1.25 時間(3 ポモドーロ) 0
休日の勉強時間 約 12.9 時間 約 14.2 時間(34 ポモドーロ) 約 10 時間(24 ポモドーロ) 約 14.2 時間(34 ポモドーロ) 0
「セキュアで信頼性のあるシステム構築」/「データベースリライアビリティエンジニアリング」勉強会 0 時間 約 1.0 時間 約 1.5 時間 約 1.0 時間 0
そのほかの勉強会 0 時間 0 時間 0 時間 0 時間 0
合計 約 22.5 時間 約 33.6 時間 約 22.3 時間 約 21.0 時間 約 4.58 時間

12 月の OKR 結果

2024 年 1 月〜3 月の目標

2024年1月〜3月の目標に記述した OKR 目標は SRE・DevOps、Kotlin、英語です。 具体的には下表の通りになります。

注力分野 Objective(3 ヵ月経過後の目標) Key Result(必要だと考えていること)
SRE・DevOps SRE の考え方を学ぶのはいったん完了とする。スクラムによって仮説検証を回すプロセスを体験する 書籍ベースの SRE の学習にひと区切終える。スクラム開発を実践する。
Kotlin 自身の Kotlin の知識を把握して、新しい知識を拡充する 自身が作成した書籍の更新。公式ドキュメントを読む
英語 英語で技術系のコンテンツをなんとなく読めるようになる 基本的な英語の知識から始めて、3 月には技術系記事に対してやってみる

2024 年 2 月の OKR 目標

注力分野 Objective(1 ヵ月度ごとの目標) Key Result(具体的な行動予定)
SRE・DevOps 書籍ベースで、SRE を学ぶ。業務でスクラムを実践した結果を振り返る、必要な知識を拡充する 「セキュアで信頼性のあるシステム構築」の勉強会を実施する。「データベースリライアビリティエンジニアリング」の勉強会を実施する。
Kotlin 自分が持っている Kotlin の知識を更新する Spring Boot の標準例外や null のバリデーションエラーについて調査する。「ハンズオンで学ぶサーバーサイド Kotlin」を Spring Boot 3 に更新する
英語 英語学習を継続している バイリンガルニュースを聞き、英語の技術書を読む。できた日をカウントする

2024 年 2 月の OKR 結果

今月は以下のようになりました。

注力分野 達成度(100 点満点) Key Result(行動結果)
SRE・DevOps 70 点 予定通り「セキュアで信頼性のあるシステム構築」/「データベースリライアビリティエンジニアリング」を終えた。スクラムを業務で実践し、短期間で課題を発見し解決する経験を得ている。
Kotlin 90 点 zenn に記事を 3 つ投稿した。「ハンズオンで学ぶサーバーサイド Kotlin」を v2 に更新した
英語 40 点 自分の勉強方針を確立した。2 週目までは継続できていたが、優先順位が下がって実践できなかった。

注力分野の振り返り

SRE・DevOps

SRE・DevOps は 70 点でした。 理由は当初の予定通り SRE の書籍を読み終えたことと、スクラムを実践できていることです。

前者については、以前から読んでいた「セキュアで信頼性のあるシステム構築」を読み終えて、今月から読み始めた「データベースリライアビリティエンジニアリング」も読み終えました。 「セキュアで信頼性のあるシステム構築」は、全体的に難易度が高く、身近なものでなかったため、途中から読み飛ばしてしまいました。 「データベースリライアビリティエンジニアリング」は、DB に特化した内容は全体的に少なく、ページ数も少なかったので読み物として読みました。 具体的に活かせることは少なかったのですが、ほかの SRE の書籍において DB が語られていたときと同様に、DB に対する知見が少ないことに危機感を覚えました。 現在の優先順位は低いですが、計画を立て学ぼうという心持ちになっています。
先月の終わりぐらいから SRE 関連の業務に携わり始めました。 まだ、学ぶ立場のため他チームで導入した過程などを聞くことが主な内容となっています。

後者については、スクラムに沿った業務の進め方をしています。 経験者はいませんが、1 スプリントを区切って実践し、経験値を溜めています。 1 週間前と同じことをしないように意識して取り組んでいます。

総じて目標に掲げていたことを実践できた月でしたが、引き続き課題があります。
SRE については、一通りの書籍をようやく読み終えた状態です。 知っていることは増えましたが、経験値は圧倒的に足りません。 幸運なことに SRE 関連の業務に参画できるため、経験を得る機会があります。 参画しても、いつまでも学ぶ立場でいないように目標と期待値調整をしつつ取り組みます。
スクラムで実感したことは、課題を解決しようとして別の課題を作ってしまうことです。 すべてのやり方にメリットデメリットがあるため、どこかを調整しようとすると必ず課題が出てきます。 そういったときに、どちらが適切なのかを確認するために、1 スプリント利用する機械が多かったです。 この課題に対しては目的意識が一致していないと思いました。 どこかで、目的の一致を作成する機会を考えています。

Kotlin

Kotlin は 90 点でした。 理由は、以下の 3 つです。

今月は書籍の更新を目的にしていました。 その過程で自分の知見から欠落していた部分を可視化して、以下の記事にまとめました。

そして、ようやく「ハンズオンで学ぶサーバーサイド Kotlin」の更新ができました。 主な変更点は書籍に書いているので、ここでは省略します。 zenn の書籍機能で無料公開しているおかげで、内容が多くても更新のハードルが低かったと思いました。 何はともあれ達成感が強いです。

今回の内容で、サーバーサイド Kotlin LT 大会 vol.11で登壇することにしました。 初めてのパブリックな LT 会で登壇するので、非常に緊張しています。 最終的には、Kotlin Fest 2024 へのプロポーザルを見据えているので、ここで所感をつかみたいと考えています。

まとめると、時間をかけて取り組めた月でした。 反省点は、2 つあります。 1 つめは、「ハンズオンで学ぶサーバーサイド Kotlin」を 1 人で一気に更新したので、あまり質に自身がないことです。 2 つめは、計画性がなく勉強の配分に偏りがうまれてしまったことです。特に後述の英語は引越しの準備と合わせて時間を大きく削ることになってしまいました。

来月は、サーバーサイド Kotlin LT 大会 vol.11の準備とライブラリを読んでいこうと考えています。

英語

英語は 40 点でした。 理由は、ほかの勉強や引越しの準備を理由に習慣から外してしまったからです。 良かった点として、ポッドキャストによるリスニング力の向上のための勉強方法と日々の記録方法を確立できましたが、途中からやっていない日の方が多くなってしまいました。

簡単な振り返りを記述します。 英語の技術書を読むのは継続しています。 具体的には以下の本を読んでいました。この書籍を選んだ理由は、第一版を日本語で読んだことがあるため、ある程度雰囲気でよめそうだと考えたからです。 一応読めますが、読むスピードが遅いため課題もあります。

  • The Scrum Field Guide: Agile Advice for Your First Year and Beyond, Second Edition

ポッドキャストは、最初はバイリンガルニュースにしていましたが、技術的な内容に絞りたくなりました。 そのため、zenn の scrap で 英語の tech 系 podcast をまとめる にまとめました。

調査したところ、とりあえず更新頻度が高いものと、transcript があるものに絞って聞いた結果、Software Engineering Daily にしました。 領域は業務に無関係ですが、直近の話題をネイティブが喋るスピードで学ぶことができました。 問題点は早すぎて transcript を見ても追いつかないことです。 これについては、来月以降も継続することで対応します。

来月の実践することは、勉強計画を 1 ヵ月をやりきることです。 引越しも途中で落ち着くので、再開できると考えています。

3 月の OKR

3 月の OKR は下表のようにします。

注力分野 Objective(1 ヵ月度ごとの目標) Key Result(具体的な行動予定)
SRE・DevOps 書籍ベースで、SRE に区切りをつける。業務でスクラムを再度実践する SRE 関連の業務に携わる機会があるので、現状の整理と目標設定を実施する
Kotlin LT で発表する。Arrow のコードリーディングする サーバーサイド Kotlin LT 大会 vol.11で発表する。Arrow のコードリーディングの計画を立てる
英語 英語学習を継続している 2 月に決めた勉強内容で実践する

読書

セキュアで信頼性のあるシステム構築

msksgm.hatenablog.com

データベースリライアビリティエンジニアリング

技術記事の作成

今月は、月初に Kotlin の記事を 2 つ作成しました。zenn のスクラップに英語の tech 系 podcast をまとめるを作成しました。

Kotlin × Spring Boot の 400 系の標準例外をハンドリングする

zenn.dev

Kotlin × Spring Boot 3 でコントローラの null 非許容型のバリデーションを 3 種類の方法で実装

zenn.dev

Kotlin × Spring Boot 3 で ConstraintViolationException のパラメータを変換する

zenn.dev

その他

特になし。

2 月の振り返りまとめ

今月は Kotlin を重点的に実施した月になりました。 後半は引越しの準備があったため、勉強時間をおけない月もありましたが、最優先事項の Kotlin は終えられて良かったです。 しかし、来月の頭には生活リズムが確実に崩れるので、対応していきます。

「セキュアで信頼性のあるシステム構築」感想

概要

セキュアで信頼性のあるシステム構築を読みました。 感想を書きます。

前提

目的

本書を読んだ理由は以下です。

事前知識

業務で SRE チームや関連の領域に所属しておらず、自社開発企業のプロダクト開発エンジニアとして働いています。 SRE は業務外の範囲で知見を深めており、学んだことを業務に導入したりしています。 直近では、ポストモーテムの作成文化、SLO の考え方の導入、モニタリング・オブザーバビリティについての基礎知識の共有といったことを行いました。

SRE 関連の書籍は以下を読んでいました。

DevOps 関連で言えば以下の書籍を読んでいました。

他にもSRE NEXT 2023 に参加することで、SRE の日本企業の事例も学びました。 当時の参加感想は以下の記事にまとめました。

msksgm.hatenablog.com

読了時間

個人的に勉強会を開催し、以下の日程で読み進めていました。 全 7 回で、準備に約 1.5 時間かけて、当日の勉強会でも 1.5 時間ほど実施しました。 そのため、合計所要時間 21 時間ほどでした。

No. 日付
1 2023/12/26 第 Ⅰ 部 1 章 ~ 第 Ⅱ 部 4 章
2 2024/01/02 第 Ⅱ 部 5 章~ 6 章
3 2024/01/09 第 Ⅱ 部 7 章~ 8 章
4 2024/01/16 第 Ⅱ 部 9 章 ~ 第 Ⅲ 部 11 章
5 2024/01/23 第 Ⅲ 部 12 章 ~ 13 章
6 2024/01/30 第 Ⅲ 部 14 章 ~ 第 IV 部 18 章
7 2024/02/06 第 Ⅴ 部 27 章 ~ 29 章

感想

SRE が信頼性の観点からエンジニアリングしたのと似たように、セキュリティ観点からエンジニアリグする手法について述べた内容です。 セキュリティをエンジニアリングするための、コードに限らない組織的な部分についての解説について貴重でした。 しかし、これらを実践するには組織の意思決定する立場だったり初期の段階から参画しなければならなかったりと、自分の立場から掛け離れすぎていて、内容が入ってこない部分も多かったです。

個人的に良かった点は、SLO 以外のエンジニアリング対象としてセキュリティのエンジニアリングについてまとめられた書籍だったことです。 SRE として信頼性のエンジニアリングをセキュリティにも組み込むとこのようになると実感できました。 さまざまな会社が各々の SRE 業務を実施していますが、本書のレベルまでまとめられた良いのではないかと思いました。

難しかった点は先述の内容と一部重複しますが、以下です。

  • 内容が組織の意思決定する立場である必要がある
  • 初期の段階から参画していないとどうしようもない部分がある
  • 本書に書かれているレベルの組織体系は、あまり身近でない部分が多い

総じて、自分が SRE に携わった経験がないことから、読み進めにくい部分が非常に多かったです。 SRE を実践した後に、再度読み直そうと思いました。

次に関連で勉強すること

引き続き SRE 関連の書籍を読み進めていきます。 SRE の読み物として読んでいないのは以下だけです。

余力が残っていたら以下の書籍も読みます。

まとめ

SRE がセキュリティを信頼性と似たような考え方でエンジニアリングすることについてまとめられた書籍でした。 考え方が全体として学べる部分もあったものの、自分は SRE 未経験ですので、難解な部分の方が多かったです。

2024年2月の目標

概要

2024 年 2 月の目標です。

勉強関連

SRE・DevOps、Kotlin、英語を対象に OKR を実施しています。

1 月〜3 月の目標

1 月〜3 月を終えた時点での目標は下記です。

注力分野 Objective(3 ヵ月経過後の目標) Key Result(必要だと考えていること)
SRE・DevOps SRE の考え方を学ぶのはいったん完了とする。スクラムによって仮説検証を回すプロセスを体験する 書籍ベースの SRE の学習にひと区切終える。スクラム開発を実践する。
Kotlin 自身の Kotlin の知識を把握して、新しい知識を拡充する 自身が作成した書籍の更新。公式ドキュメントを読む
英語 英語で技術系のコンテンツをなんとなく読めるようになる 基本的な英語の知識から始めて、3 月には技術系記事に対してやってみる

2 月の目標

それを達成するための 2 月の目標は以下になります。

注力分野 Objective(1 ヵ月度ごとの目標) Key Result(具体的な行動予定)
SRE・DevOps 書籍ベースで、SRE を学ぶ。業務でスクラムを実践した結果を振り返る、必要な知識を拡充する 「セキュアで信頼性のあるシステム構築」の勉強会を実施する。「データベースリライアビリティエンジニアリング」の勉強会を実施する。
Kotlin 自分が持っている Kotlin の知識を更新する Spring Boot の標準例外や null のバリデーションエラーについて調査する。「ハンズオンで学ぶサーバーサイド Kotlin」を Spring Boot 3 に更新する
英語 英語学習を継続している バイリンガルニュースを聞き、英語の技術書を読む。できた日をカウントする

読書

OKR の本では下記の本を読みます。

2024年1月の振り返り

概要

2024 年 1 月の振り返りです。

勉強概要

今月は下表のように勉強していました。 合計、約 118.5 時間です。

項目 1 週目(1 月 1 日〜1 月 7 日) 2 週目 3 週目 4 週目 5 週目(1 月 29 日 ~ 1 月 31 日)
平日朝の勉強時間 約 2.5 時間(5 ポモドーロ) 約 13.3 時間(32 ポモドーロ) 約 12.9 時間(31 ポモドーロ) 約 14.6 時間(35 ポモドーロ) 約 7.92 時間(17 ポモドーロ)
平日夕方の勉強時間 0 時間 約 1.25 時間 約 1.67 時間(4 ポモドーロ) 0 時間 0 時間
休日の勉強時間 約 25 時間 約 13.8 時間 約 9.17 時間(22 ポモドーロ) 約 10.4 時間(25 ポモドーロ) 0 時間
「セキュアで信頼性のあるシステム構築」勉強会 約 1.5 時間 約 1.5 時間 約 1.5 時間 約 1.5 時間 約 1.5 時間
そのほかの勉強会 0 時間 0 時間 0 時間 0 時間 0 時間
合計 約 29 時間 約 28.4 時間 約 25.2 時間 約 26.5 時間 約 9.42 時間

12 月の OKR 結果

2024 年 1 月〜3 月の目標

2024年1月〜3月の目標に記述した OKR 目標は SRE・DevOps、Kotlin、英語です。 具体的には下表の通りになります。

注力分野 Objective(3 ヵ月経過後の目標) Key Result(必要だと考えていること)
SRE・DevOps SRE の考え方を学ぶのはいったん完了とする。スクラムによって仮説検証を回すプロセスを体験する 書籍ベースの SRE の学習にひと区切終える。スクラム開発を実践する。
Kotlin 自身の Kotlin の知識を把握して、新しい知識を拡充する 自身が作成した書籍の更新。公式ドキュメントを読む
英語 英語で技術系のコンテンツをなんとなく読めるようになる 基本的な英語の知識から始めて、3 月には技術系記事に対してやってみる

2024 年 1 月の OKR 目標

注力分野 Objective(1 ヵ月度ごとの目標) Key Result(具体的な行動予定)
SRE・DevOps 書籍ベースで、SRE を学ぶ。業務でスクラムを実践してみる 「セキュアで信頼性のあるシステム構築」の勉強会をやる。
Kotlin 自分が持っている Kotlin の知識を更新する ハンズオンで学ぶサーバーサイド Kotlin」更新のために、SpringDoc を調査して実践する。
英語 英語学習のとっかかりをつかむ 自分にあった英語の学習方法を模索する。

2024 年 1 月の OKR 結果

今月は以下のようになりました。

注力分野 達成度(100 点満点) Key Result(行動結果)
SRE・DevOps 75 点 「セキュアで信頼性のあるシステム構築」の勉強会を実践し、全 7 回中 6 回を終えた。 スクラムを実践している。 Docs as Code を導入してみた
Kotlin 80 点 SpringDoc を調査し、実装方法をまとめて zenn に投稿した
英語 60 点 英語の技術書とバイリンガルニュースで英語学習を開始した

注力分野の振り返り

SRE・DevOps

SRE・DevOps 観点は 75 点程度です。 理由は以下の 3 つを実践してたからです。手広く実践できましたが、課題感も多いので原点しました。それぞれについて深堀します。

  • SRE の勉強を継続して実践した。しかし、内容的に難易度や具体性が高くあまり身についていない
  • 業務でスクラムを導入し、未経験だがスクラムマスターとしてリードしている。しかし、未経験なのでタイムボックスを守れなかったり意思決定が追いつかなかったりする
  • docusaurus を用いて Docs as Code の実現に成功した。ただし、まだ効果を実践する前の状態

SRE は書籍ベースでの学習のため「セキュアで信頼性のあるシステム構築」を読んでいます。 だいたい 9 割ほど読み終わり、あと 1 回実施したら終わりです。 内容が Google に偏った内容が多いことや、組織の上位層が考えることだったりしたため、身に入る部分が少なかったです。 参考になることもあるんですが、自分に関連しないことが多いので、途中から飛ばし読みになってしまいました。

業務でスクラムを導入しました。 誰も経験者がいないので、自身がスクラムマスターとして振る舞っています。 まだまだスクラムイベントをこなせなかったり、チームとしても目標にコミットできていなかったりと、完成度としてはまだまだです。 それらも含めて楽しみつつ経験になっています。 しかし、組織的な課題が非常に多いので、スクラムの完成度が低いまま中途半端な状態で終わりそうです。

最後に Docs as Code の実践です。 業務効率の改善やプロダクト品質向上のため、ドキュメントのコード化に以前から興味がありました。 そこで、docusaurus を用いたドキュメントのコード化を実践しました。 具体的には、PR の作成タイミングで docusaurus のアプリケーションを作成しレビュー、マージしたら GitHub Pages にデプロイするしくみです。 やりたいことの実装方法を 2 週間程度で理解し導入しました。 発想自体は正しいと考えていますが、メリットがでるのは保守や差分のレビュー時だと考えているので、まだ費用対効果を評価できていないことが課題です。
ドキュメントのコード化を調査していくうちに、Docs as Code の存在を知りました。 タイトルの通りでドキュメントをコードのようにバージョン管理、マークアップ言語、コードレビューなどを組み込むといった内容です。 より知見を深めるために、Crafting Docs for Success : An End-to-End Approach to Developer Documentationを読み終えました。

DevOps 関連では、学習する組織を読み感想文を書きました。 マネジメントの内容で、出版が 1990 年ですが現代にも通じる内容が詰まっており、非常に感銘をうけました。

総じて、今月も自分の興味のあることに対して探求し必要であれば実践できました。 しかし、どれも課題が多いです。 個人的な勉強の範疇では問題ありませんが、チームに導入したことは負債となります。 自身の異動の話がでており、中途半端な状態になる可能性が非常に高いので、来月はそれらの改善に取り組みたいです。

Kotlin

Kotlin は 80 点でした。 理由は当初の予定だった SpringDoc の調査を一通り終えたからです。 zenn に記事 Kotlin + Spring Boot 3 + Springdoc-openapi で OpenAPI ドキュメントを作成する として公開しました。 予定通り終えられて勘所もつかみましたので、「ハンズオンで学ぶサーバーサイド Kotlin」に反映できそうです。

しかし、実装面において別件で気になったことやまとめたいことが出てきたので、来月の最初はそれを実践します。 具体的には、以下の 2 つを調査して投稿します。

  • Spring Boot の標準例外ハンドラについて
  • 必須 or null のバリデーションエラーの実装方法について

とりあえず、目標通りで順調です。 残ったタスクも 2 月の早いうちにこなします。

英語

英語は 60 点でした。 英語の勉強方法を検討し、決めたからです。 1 週目ぐらいに、勉強方法を考え以下の 2 つを検討しました。 どちらもなんとかして技術系の英語を学ぶきっかけになればと考えています。

  • バイリンガルニュースを聞くことで、リスニング力を鍛える
  • 毎月、比較的難易度が低い or 邦訳版を読んだことがる英語の技術書を読む。読んだら感想文を登録する

前者は比較的難易度の高いリスニングを学べそうだから選択しました。 前者はスマートフォンポッドキャストで聴講可能ですので、利用しました。 1 日 30 分ほどでも進められるように、普段のスケジュールの見直しをしています。 後者は技術英語を学ぶためです。 自分の興味がある分野からできたらと考えています。 とりあえず、課題図書はCrafting Docs for Success : An End-to-End Approach to Developer Documentationを考えています。 今月末までにどのような効果が得られるのかを考えます。

後者はとりあえず読書感想文まで書きました。 前者はあまり継続できていません。

来月は実践できた日、できなかった日をそれぞれカウントすることで対応しようと考えています。

2 月の OKR

2 月の OKR は下表のようにします。 内容が継続的な学習となっているので、都度具体的な学習に移していきます。

注力分野 Objective(1 ヵ月度ごとの目標) Key Result(具体的な行動予定)
SRE・DevOps 書籍ベースで、SRE を学ぶ。業務でスクラムを実践した結果を振り返る、必要な知識を拡充する 「セキュアで信頼性のあるシステム構築」の勉強会を実施する。「データベースリライアビリティエンジニアリング」の勉強会を実施する。
Kotlin 自分が持っている Kotlin の知識を更新する Spring Boot の標準例外や null のバリデーションエラーについて調査する。「ハンズオンで学ぶサーバーサイド Kotlin」を Spring Boot 3 に更新する
英語 英語学習を継続している バイリンガルニュースを聞き、英語の技術書を読む。できた日をカウントする

読書

学習する組織

msksgm.hatenablog.com

Crafting Docs for Success : An End-to-End Approach to Developer Documentation

msksgm.hatenablog.com

技術記事の作成

Kotlin の目標に掲げていた SpringDoc の記事を作成しました。 3 月までは継続して投稿します。

Kotlin + Spring Boot 3 + Springdoc-openapi で OpenAPI ドキュメントを作成する

zenn.dev

その他

特にありません。 Kotlin 関連の LT 会で発表しようと考えています。

1 月の振り返りまとめ

2024 年 1 月最初の振り返り記事でした。 とりあえず新年やろうと決めたことは、一通り方向性を定められたと考えています。 毎回 3 ヵ月の最初は難易度が低いので想定よりもよくやれたと考えています。 来月は日付が少ないので、実践できることが少ないと想定しつつ、実践します。

今月の課題も、他人を巻き込んだ設定の実践の難しさです。 個人の範囲では成功失敗は自己責任で済みますが、チームや他人を巻き込んだ場合はそうでありません。 自分の考え方や課題感が周囲に一致していないと、単純にやることが増えるだけだと、とらえられてしまします。 そういった部分が非常に難しく、あと 2 ヵ月で解決できるきがしません。 とりあえずは「学習する組織」で書いてあった、「システムで解決する」を意識します。

2024 年の最初から、業務面と個人の勉強面の両方でさまざまなことが起きています。 自分が制御できることとできないことがありますが、自分の目標を見失わないように取り組んでいきます。