201207 ssmjp

1,023 views

Published on

2012年7月の#ssmjpでの発表資料です。リーダブルコードに感激してお勧めしてきました。

Published in: Education
0 Comments
1 Like
Statistics
Notes
  • Be the first to comment

No Downloads
Views
Total views
1,023
On SlideShare
0
From Embeds
0
Number of Embeds
32
Actions
Shares
0
Downloads
0
Comments
0
Likes
1
Embeds 0
No embeds

No notes for slide
  • \n
  • \n
  • \n
  • \n
  • \n
  • \n
  • \n
  • \n
  • \n
  • \n
  • \n
  • \n
  • \n
  • \n
  • \n
  • \n
  • \n
  • \n
  • \n
  • 201207 ssmjp

    1. 1. Undocumented... 2012/07/23 #ssmjp th0x0472
    2. 2. お約束Twitter @th0x0472フォローするときはよく考えて。アンフォローはお気軽に。Blog http://th0x0472.at.webry.info/
    3. 3. ところで みなさん、コード書いてますか?Shell script, C/C++, Python, Perl, Ruby, C#, Java, Assembler, Java Script, Visual Basic, VBScript, etc... (並び順に深い意味はありませんよ・・・?)
    4. 4. 文章は書いてますよねメール、ツイッター、ブログ各種連絡、報告書、議事録仕様書、設計書、手順書 etc...
    5. 5. 今日のお題リーダブルコードより良いコードを書くためのシンプルで実践的なテクニックDustin Boswel, Trevor Foucher著角 征典訳オライリー 2012年6月(ISBN:978-87311-565-8)www.oreilly.co.jp/books/9784873115658/
    6. 6. 目次1章 理解しやすいコード 9章 変数と読みやすさ2章 名前に情報を詰め込む 10章 無関係の下位問題を抽出する3章 誤解されない名前 11章 一度に1つのことを4章 美しさ 12章 コードに思いを込める5章 コメントすべきことを知る 13章 短いコードを書く6章 コメントは正確で簡潔に 14章 テストと読みやすさ7章 制御フローを読みやすくする 15章 「分/時間カウンタ」を設 計・実装する8章 巨大な式を分割する
    7. 7. 「優れた」コードって何?return exponent >= 0 ? mantissa * (1 << exponent) : mantissa / (1 << -exponent); (本書 2ページより)アイツは行っちまったのさ・・・それこそ均一なるマトリクスの裂け目の向こうへ・・・あいつは確かに活きてる。広大なネットのどこか、あるいはそのすべての領域に融合して。
    8. 8. 「優れた」コードって何?if (exponent >= 0) {     return mantissa * (1 << exponent);} else {     return mantissa / (1 << -exponent);} (本書3ページより)シーザーを理解するためにシーザーである必要は無い。
    9. 9. 読みやすさの基本定理 となる考えコードは他の人が最短時間で理解できるように書かなければいけない。 (本書 3ページより)
    10. 10. 「他の人」?どうせ誰も読まないし他の人なんか知ったこっちゃないし俺はマテバが好きなの!
    11. 11. 「他の人」?金曜日の自分と次の月曜日の自分。夏休み前の自分と夏休み明けの自分。半年後の自分。5年後の自分。
    12. 12. 僕の場合先週書いたコードの理屈をぱっと思い出せなかったことがあります。よくあります。(そもそも休みの日まで仕事のコトを覚えていたくない)あるプロジェクトを離れてから4,5年後に自分が書いたスクリプトが使い続けられてるという話を聞いたことがあります。
    13. 13. コードの話でしょ?根幹のメッセージは普遍的。むしろコード以外の各種文書の方が改善する余地が大いにあると思う。エンジニアの共通言語=コードなだけ。
    14. 14. 簡単に紹介すると明確で正確な表現 vs 気取った言い回し具体的な表現 vs 名状しがたい・・・重要な情報を欠落させない誤解を招かない表現 当たり前? ちゃんと出来てますか?
    15. 15. 簡単に紹介すると全体像を説明する自分の考えを記録する読み手の期待を理解する読み手に書き手の意図を伝える こんな普遍的なお話が詰め込まれてます
    16. 16. そんなわけでコードを書くのが大好きな方はもちろんコードに限らず、何らかの文書を書く方あまり書きたくない方、読みたくない方 みんなにお勧めです。 (どちらかと言えばむしろ後にあげた方に強くお勧め)
    17. 17. でも・・・お高いんでしょう?紙の書籍で ¥2,400− (税別)電子書籍で ¥2,016− (税込み?)分厚いんでしょう?本文、解説、索引で237ページ。
    18. 18. ところでそもそも、ドキュメントが存在しない、更新されていない・・・そんなときは、Sphinxですよ。 http://sphinx-users.jp/
    19. 19. おしまいご清聴ありがとうございました。

    ×