= 概要 : author 結城洋志 : institution 株式会社クリアコード : content-source 実践リーダブルコード : date 2019-09-24 : allotted-time 30m : theme clear-code = 今日の流れ - 午前 * 10:30- アイスブレーク * 10:45- 概要と進め方の説明 * 11:15- 実装 * 11:45- ランチ = 今日の流れ - 昼下がり * 12:45- 実装の続き * 13:45- 読み方のデモ * 14:00- チェンジして実装 * 15:30- グループふりかえり = 今日の流れ - 夕方 * 16:10- まとめ * 次のステップを説明 * 16:30- 感想発表・ディスカッション = チューター紹介 * 参加者のサポート係 * 現役エンジニア * 行動指針 * 参加者が目的を見失うのを防ぐ * 新しい視点を与える = 講師紹介 (('tag:center'))(('tag:margin-bottom * 2')) 結城洋志（ゆうき ひろし） * クリアコード所属 * 進行と全体を気にかける係 = 講座の目的 * 自分の開発チームに * ↑注意：個々人の話ではない * ((*リーダブルなコードが\n 当たり前な文化の作り方*))を * 持ち帰る (('tag:center')) (('note:→ 「解説」に書いていることの実践方法を学ぶ')) = 目的でないこと * 実践前の不安のケア * やらない理由の増幅は抑えられない * ↑のときに外からの声は届かない * 例：上司の説得方法の伝授 * 時間が残ったら参加者同士で\n 情報交換する場を用意 * ↑を活用するのは可 = サポート * 今日の資料はすべて再利用可能 * チーム内で同じ講座を再現できる = そもそもの話 * リーダブルコードはなぜ必要か (('tag:center')) ↓を目指すために\n チームでの共有は必須\n \n リーダブルなコードが\n 当たり前な文化 = 必要なケース チーム開発 = チーム開発 * 1人しか触れないコード→危険 * いなくなったら変更できない * 変更できてもコストが大きい * チームで触れるには？ (('wait')) (('tag:center')) ↓\n 既存コードの理解が必要 = 既存コードの理解のため リーダブル\n コード = 既存コードの理解しやすさ * コードの変更コストに影響 * コスト↑→修正・機能追加の時間↑\n (('note:（理解しないと変更できない）')) * コスト↑→リグレッションバグ↑\n (('note:（理解しないまま変更すると問題発生）')) (('wait')) (('tag:center')) ↓\n 理解しやすさ→開発速度に影響 = 時間が経つほど影響大 # image # src = images/readable-code-reasonability.svg # relative_width = 90 == プロパティー : enable-title-on-image false = リーダブルコードの必要性 * チームの開発速度の維持のため * 継続的に改良・修正したい * それも現実的なコストで = 必要性の実現方法 コードを読む\n 文化を作る = 読む？書くじゃないの？ * リーダブルコードを書くには\n コードを読まないといけない * なぜ？ (('wait')) (('tag:center')) リーダブルコードは\n チーム毎に違うから = リーダブルコード 「読む人」が\n 読みやすいなら\n リーダブル = 読む人 * 多くの場合、いない * チームのコードを読んでいますか？ * 読む人（チームメンバー）毎に\n リーダブルの基準は違う * 背景が違うので当たり前\n (('note:（背景：使ってきた言語・今の知識）')) = チームでのリーダブル * 1つずつ見つけていくしかない * 各メンバーの読んだ感覚を\n チームで共有 * 既存の基準をベースにするのはアリ\n (('note:（基準：本の内容やコーディングスタイルなど）')) (('tag:center')) チームでのリーダブルコードは\n 育てていくもの = リーダブルの基準の育て方 * コードを読む文化を作る\n (('note:（最初の難関）')) * チームのコードの中から\n リーダブルなコードを見つける * リーダブルなコードを\n チームで共有 * ↑の繰り返しで基準を増やす = コードを読む文化を作る * まず自分が読み始める * 仲間がいると心強い * リーダブルなコードを探す * 読みにくいコードは今は置いておく\n (('note:（チームにコードを読む文化ができてから！）')) * 見つけたリーダブルなコードは… = リーダブルなコードは… * 他のメンバーに教える\n (('note:（例：話しかける。チャットに書く。Wikiにまとめる。）')) * 「○○さんの△△という書き方、\n リーダブルでしたよー」 (('tag:center')) ↓\n 読みやすさの基準を共有\n コードが読まれているという自覚 = 読むことを「当たり前」に * 「あいつはコードを読むやつ」\n という認識を広める * 自分だけからチームへ (('tag:center')) …続きはセミナーの最後に = ワークショップ内容 (('tag:center')) 改良するために\n 他の人のコードを読む * 「まず自分が読み始める」 * 「リーダブルコードを探す」\n (('note:（読みにくいコードは今は置いておく）')) * 「リーダブルの基準を共有」\n (('note:（チームでのリーダブルコードができる）')) = 注意：やらないこと (('tag:center')) リーダブルコードを書くための\n テクニックをたくさん伝授 ((' ')) = テクニック伝授は範囲外 * 順番が違う * まず読む文化を作ること * 今日は↑がメイン * テクニックはその後 * 読む文化ができていれば\n 効率的に広められる * よい書き方でコードを書けば\n みんながコードから学んでくれる！ = やること 読む文化作りの\n 体験 = 読む文化作り * まず自分が読み始める * リーダブルコードを探す * 他のメンバーに教える = 読む文化作りの体験 * 10:45- 課題を実装 * リーダブルコードを書く * 14:00- 実装チェンジ→開発継続 * 「まず自分が読み始める」 * 「リーダブルコードを探す」 * 15:30- グループふりかえり * 「他のメンバーに教える」 = おさらい * 講座の目的 * リーダブルコードの必要性 * 講座でやること = 講座の目的 * 自分の開発チームに * ↑注意：個々人の話ではない * ((*リーダブルなコードが\n 当たり前な文化の作り方*))を * 持ち帰る = リーダブルコードの必要性 * チームの開発速度の維持のため * 継続的に改良・修正したい * それも現実的なコストで = 変更コストと開発速度 # image # src = images/readable-code-reasonability.svg # relative_width = 90 == プロパティー : enable-title-on-image false = 講座でやること * コードを読む文化作りの体験 * まず自分が読み始める * リーダブルコードを探す * 他のメンバーに教える