変数名からプルリクエストまで、チーム開発のための伝わる「言葉」の選び方 by おおしげ

開発ではコードを書く時間よりも読む時間の方が長いと言われていますし、コードレビューを通してコミュニケーションをとることも日常茶飯事です。
そんなとき、このような経験は無いでしょうか？

• 何をしている変数なのか全然わからない
• メソッド名からは伝わらない実装のサプライズ
• コードコメントが実装を説明しただけ
• 何をどういう条件で検証したいテストなのか不明
• コミットメッセージが「指摘箇所修正」ばかり
• PRで実現したかったことがわからず本質的なレビューができない

命名であったり設計であったりコードレビューであったり分野は少し異なっているように見えますが、これらは全て書き手が選択した「言葉」を使って表現されているという共通点があります。

本セッションでは、「言葉」という共通点に注目しつつ、チーム開発において伝わる「言葉」とは何か、伝えるために必要なことについて発表します。