開発者は仕事でリーダブルなコードを書けるのか？

開発者は仕事でリーダブルなコードを書けるのか？ Powered by Rabbit 2.0.7

開発者は仕事でリーダブルなコードを

書けるのか？

須藤功平株式会社クリアコード

Developer Migration 20132013/03/02

対象

開発者

リーダブルなコード？

例1: リーダブル？

class Person def initialize @mutex = Mutex.new end def name=(name) @mutex.synchronize do @name = name end endend

例2: リーダブル？

class Person def initialize @mutex = Mutex.new end def name=(name) synchronize do @name = name end end def synchronize @mutex.synchronize do yield end endend

参考

Ruby コードの感想戦http://jp.rubyist.net/magazine/?0040-CodePostMortem✓

http://jp.rubyist.net/magazine/?0041-CodePostMortem✓

ヒント

コードはコンピューターが実行するだけではない

読む人がいる✓

コードは書いた人の意図を語る✓

リーダブルなコード

わかりやすい（書いた人の意図が）✓

直しやすい✓

調べやすい✓

試しやすい✓

で？

リーダブルなコードってうれしいの？

開発者として

ストレスが減る(1)

ストレス

なにしてるか全然わからないんだけど！

ストレス

なにしたいか全然わからないんだけど！

開発者として

楽しい(2)

楽しい

すぐに対応できる

すぐに対応

こういうのが欲しいんだけどあ、ちょっと待ってください。✓

こんな感じですか？✓

→そう！こういうの！✓

→あぁ、こうなるのかぁ。じゃあ、なしで！

すぐに対応

オレってばスゲー感

http://kitaj.no-ip.com/tdiary/20040404.html#p05

オレってばスゲー感を

他の人のコードで、じゃなく✓

自分たちのコードで！✓

作らないのがいい？

本当に必要？検討しましょう！必要？本当に？本当に？✓

考えている間に試したら？コードを書かない事が目指す事？✓

必要ないものに時間をかけない事じゃない？

コストが下がれば試せる

コストが下がる

実サーバー → 仮想マシンすぐに追加できる✓

すぐに削除できる✓

試せる

実サーバー → 仮想マシンどのくらいあらかじめ用意する？ →✓

いつどうやって増減させる？✓

コードだって同じ

リーダブルなコードなら

素早く対応できる

素早い対応

うわぁ！こんなに素早く対応してもらえるなんて！ありがとう！

素早くない対応

このくらいで終わりそうでも、なんかあったらイヤだなぁ✓

バッファで2倍かかることにしよう✓

困ったらすぐ相談じゃダメ？全体でよくなるように進めないの？✓

信用

いつも素早く対応してくれる人が時間がかかるっていうんだから大変なんだろう。

チームとして

誰でも直せる

あるべき設計を維持できる×担当じゃないからわからない…✓

×自分のところでなんとかするか…✓

助け合える✓

誰でも直せる？

直せても直しちゃダメ？エンバグしたら責任が…✓

できる人にだけ負荷がかかる？できる人ほどツライ…✓

できない人の方が得？✓

開発者は仕事で

リーダブルなコードを書けるのか？

ムリ？

コードレビュー

リーダブルなコードにするためにコードレビューっていうのを導入したいけど他の人が読んでくれないからできない。

答え

まず、あなたが読んでみませんか？

時間がない

自分は他の人のコードを読んでいる時間ないし…

答え

時間を決めて読んでみませんか？

ペースがわかったらどうやって取り組んでいけばよいかアイディアが浮かぶと思いますよ。

でも

でも、でも、でも…

コミットへのコメントサービス

クリアコードは、よいコードを書くことを当たり前にするためには、まず「みんながみんなのコードを読む」文化にすることからはじめるのがよいと考えます。

http://www.clear-code.com/services/commit-comment.html

B2DBusiness to Developer

なんで読むの？

読まないと読みやすいコードは書けない

読む人を想像しろなんてムリ✓

自分が読む人になる✓

あなたが読む事を支援

どうやって読むの？よいところを学ぶ✓

悪いところ探しではない！✓

どういうタイミングで？

pushとかcommitした後✓

一区切り付いているでしょ？✓

みんなが読む事を支援

こうすると読みやすいですよ読みにくいコードばかりだと続けられない

よいコードを見た！→真似してコミットいいね！しているだけじゃない✓

行動しているからより本物✓

コミットコミュニケーション

他の人が何をしているかわかるあの人はあそこらへん詳しそう✓

相談してみよう✓

他の人が困っていないかわかるこの1時間ひとつもコミットしていないけど大丈夫？

このコミットすごいごちゃごちゃしてるけど悩んでる？

毎日↓をコミット

今日どれくらい読めたか感覚で。70%とか。✓

今日印象に残ったコミットメモリリーク直った！✓

今日の一言感想自分のコミットが真似されていた！✓

さいごに

リーダブルなコードが大事そうな気がしましたか？

仕事でリーダブルなコードを書けそうですか？

支援があれば書けそうですか？✓

いや、でも…

自分の会社は横のつながりを推奨していないので…

答え

オープンソースソフトウェアの開発に参加してみませんか？

そこで体験してよかったら自分の言葉で説明できるはず。

開発者は仕事でリーダブルなコードを書けるのか？

Documents

仕様確認書【公開情報（年報）】 · 全入院患者部門. 仕様確認書【公開情報（年報）】

Java scriptライブラリ「wijmo（ウィジモ）」による日本仕様のUI開発

1．コード表一覧 - INPIT整理標準化データ仕様書コード表一覧【第2版】項番コード名称コード INDEX 備考 61条項コード C0230 62商標更新類変更の有無

医薬品マスタ仕様書 - jahis.jpŒ»薬品マスタ仕様書（第18版）.pdf · 2．1 マスタコード医薬情報研究所が設定する個別12桁コード（以下、YJコードと称する）を採用する。

SPANG RDF 統合的 - biosciencedbc.jp · • アプリケーション開発を促進するには、 sparqlコードを再利用する仕組みが必要 • 実行時のコマンドラインオプションにもとづいて、

COBOLの世界を拡げる - COBOLコンソーシアム－ …§は、C#もCOBOL も同じコードになる開発の仕方：コードビハインドでWeb生産性は飛躍的に向上

Users Manual YFGW410 PROFINETインタフェース‚¤ンタフェースの仕様.....G1-1 G2. 型名・仕様コード・付加コード.....G2-1 G3. 接続確認済みのPROFINET

コード決済に関する統一技術仕様ガイドライン【利用者提示型】 CPM… · コード決済に関する統一技術仕様ガイドライン【利用者提示型】

Z7 - j-itecs.co.jp · 37 5.2. 設定表示コード opto モードコードユニバーサルモード開始 (set) z7 _z7_ zz _zz_ ソフトウェアバージョン表示 z1

ダイスキャロット 3/8インチブランドサイズ荷姿産地生産国 JANコード ITFコード賞味期限袋サイズカートンサイズ主な仕様 ※推定値

～コード化の開始から頻出パターンまで～ · 大村幸敬 Amazon Web Services ソリューションアーキテクト～コード化の開始から頻出パターンまで～

StarPayAplus(マルチ QR コード決済サービスの取扱い開始に ......StarPayAplus(マルチQRコード決済サービス) の取扱い開始について. 西尾信用金庫

公共建築積算システム工種コード表 - k-ss.co.jp · 工種表 163 建具 165 塗装(標仕仕様) 167 塗装(改修標仕仕様) 169 内外装 171 構内舗装 175

備内部コード（チェックエラ－コード）考障害者 …...チェックエラーコード表（26.0.0次版30.5最新）.xls エラーコード内部コード（チェックエラ－コード）

CK-1010G（ちょ～軽）ガソリンエンジン開放型ジンJC-1516GO ガソリンエンジン開放型ジン開商品コード仕様定価区分 121602A 本 \357,000 A3

コード容量推定ツールの開発 - CYBERNET...自動車機器事業本部背景：コード推定ツール作成の動機 6 モデルで開発ループを回す ↓ 実装段階になるまで実装コードの容量が不明

Ext Jsで柔軟に開発仕事をこなす

7115．インボイス・パッキングリスト仕分情報登録...7115．インボイス・パッキングリスト仕分情報登録業務コード内容 IVB インボイス・パッキングリスト仕分情報登録

電源コードの仕様 - Cisco...B-2 Cisco 8540 ワイヤレスコントローラインストレーションガイド付録B 電源コードの仕様サポートされる電源コードとプラグ

JPXデータクラウド提供ファイルデータ仕様書db-ec.jpx.co.jp/client_info/JPX_DLSITE/html/data_detail.pdf6 業種コード Industry code 3700 業種コードを示します。※1