Self-Documenting Code のススメ方 @lovee #iosdcrc #b

https://fortee.jp/iosdc-japan-2018/proposal/3a92b6a9-1e77-4875-a46e-83912a6b25e3 我々エンジニアは嫌いなことが二つある。一つはドキュメントを書くこと、一つは人の書いたドキュメントのないコードを読むこと。 それなら、コード自体がドキュメントになっていれば、みんなハッピーなのでは? 続きを読む
0
noppe @noppefoxwolf

象さんバラバラにするのかと思った🤭 #iosdcrc #b

2018-09-20 20:36:33
crea @crea_io

#iosdcrc #b プログラマは国語力大事って話が少し実感を持って腑に落ちた。綺麗だけどわかりやすいコードを書いていく。

2018-09-20 20:36:51
shiz(しず)@翻訳本発売中 @stzn3

細かく抽象化する - いきなり具体的な実装を考えない - 複雑な機能ほどちょっとずつ考える - 部品の責務に専念する #iosdcrc #b

2018-09-20 20:37:14
Yuki Sumida @y_sumida

契約による設計っぽくて好き #iosdcrc #b

2018-09-20 20:39:23
crea @crea_io

#iosdcrc #b assertを(プロダクトコードでも)入れていく感覚、培う

2018-09-20 20:39:25
shiz(しず)@翻訳本発売中 @stzn3

暗黙の前提をなくす - いつどこで誰に呼ばれても同じ結果になるように作る - 暗黙の前提が必要である場合はassertで明示する #iosdcrc #b

2018-09-20 20:39:38
よこやす @yokoyas000

assertはドキュメントになる(前提条件を暗黙化させない)というの、↓で知って、「いいですよね〜!」という感想 speakerdeck.com/twada/php-conf… #iosdcrc #b

2018-09-20 20:40:16
shiz(しず)@翻訳本発売中 @stzn3

コメントやドキュメントは全くいらなくなる? No。 コードはWhatとHowだけしか説明できないが、Whyも必要になる。 ドキュメントはWhyにだけ専念する #iosdcrc #b

2018-09-20 20:40:46
crea @crea_io

#iosdcrc #b what how をコードで。whyをドキュメントで。

2018-09-20 20:40:47
crea @crea_io

#iosdcrc #b 予想をいい意味で大きく裏切られる発表でした

2018-09-20 20:41:02
shiz(しず)@翻訳本発売中 @stzn3

こういうのまとめてチェックできるツールがあったらいいなー。lintでできるか? #iosdcrc #b

2018-09-20 20:41:47
よこやす @yokoyas000

実装の選択しが複数ある場合の、「なぜxxxではなくyyy にしたのか(Why)」とかもコメントあるとめっちゃいいですよね(できてない #iosdcrc #b

2018-09-20 20:42:00
🐊𝕏 @alligator_tama

WhyをADRで残したりしてるな #iosdcrc #b

2018-09-20 20:42:05