リンクアンドモチベーションAdvent Calendar 2023

新人エンジニアがAPI実装をできるまでに大切だったこと

Last updated at 2023-12-16Posted at 2023-12-16

はじめに

初めまして、リンクアンドモチベーションの木村と申します。
今年の4月から新社会人として入社し、半年間の研修を経て10月から正式に配属されました。現在はバックエンドエンジニアとしてAPIの開発を中心に携わっています。

元々入社前に多少pythonで遊んではいましたが、チーム開発、アプリケーション開発の経験はなく、チームに配属された10月はAPIってなんだ？フレームワークってなんだ？と右も左も分からないレベルでした。そこから2ヶ月で、ある程度自力で実装できるレベルになりました。

そこからレベルアップをするために大切だと感じたのは以下の３点です。

これらに対してよかったアクションを計7つ備忘録的にまとめました。

開発をするにあたって、コードを書くだけでなく、開発に関わるさまざまな知識をつけることは重要です。最初は理解が浅くても、知っておくだけで、後で立ち戻って学び直すことができるからです。

実際に全部で30冊読んだ中で領域ごとに一部紹介します。

本を読んで知識をつけたところで、実務上ではわからない問題にぶつかることはよくあります。ですが、様々な手段で知識を得て課題を乗り越えることができます。

実際に検索する際の手段についてまとめました。

開発を進める中で、全体のディレクトリ構造の中で瞬時に現在地を把握することは、効率的な開発に不可欠です。

もしディレクトリの構造と役割を理解していないと、「今何を作業しているのか」「どのディレクトリのどのファイルを見ているのか」「どのファイルが参考になるか」に迷走してしまいます。

全体のディレクトリの意味を理解することで、参考にしたいファイルを簡単に見つけることができます。

実際に位置情報と、役割を覚えていくための方法として、ペアプログラミングが非常によかったです。
先輩方にまとめて時間をいただいて、作業を一緒に進めながら、ディレクトリを行き来することで、目先のコードを全体構造と紐づけることができました。
時間をかけていただいて本当に感謝しています。

開発の際、何を実装するか、どのように実装するか困った時は設計書を見るようにしましょう。
開発で行うテストや実装の根幹は設計書にあります。

実際のコーディングに追われる中で、「設計書を読んだ？」という問いに何度も直面し、設計書を読むことが開発において不可欠であることを痛感しました。

先輩に開発について相談する際、「これ」「それ」ばかりで結局何を指しているのかわからない、冗長な説明をしてしまうことがありました。

スムーズな相談をするためには、本から学んだ用語、先輩方が使っている用語を覚え、使っていくことが重要でした。

新人は視野が狭い分、先輩に開発に関する質問をするのって難しいですよね。

漠然とわからないから質問しにくい、、とか
結局「なんかここらへんでわかりません」とただ画面を見せるだけになる、、とか結構あります。

最近の質問を整理していて、以下のポイントに沿って理解度を伝えることが重要だと感じました。

これらを踏まえて、
「目的は〇〇で、実際に処理は××のようにされると認識しています。ただ、それを実際にどのように書いて良いかわかっていません。先輩のコードを理解できていないと思うので、そこの説明をしていただきたいです。」
という質問ができたらいいと思っています。

わからない時ほど、不安な気持ちになり、質問が曖昧になりますが、そういう時こそ、明確な質問を心がけましょう。

以上、ほぼ未経験の新人エンジニアがAPIの実装をしていくために踏んだプロセスでした。
上記のアクションを積み重ねつつ早く一人前のエンジニアになりたいです。

何か役に立てれば嬉しいです。
見ていただきありがとうございました。