SlideShare uma empresa Scribd logo
1 de 1
『リーダブルコード』(Dustin Boswell)に出てきたコードへのコメント記述のポイント
 コードからすぐにわかることはコメントしない
 優れたコード>ひどいコード+優れたコメント
 欠陥へのコメント:「~する可能性がある」
 「全体像」コメント:「このクラスはXXXXの処理をしてます」
 「要約」コメント:「ユーザーのロック解除」
 なんでもいいから書く

Mais conteúdo relacionado

Mais de Ayumu Kohiyama

『人事の定量分析』(林 明文)のエッセンス
『人事の定量分析』(林 明文)のエッセンス『人事の定量分析』(林 明文)のエッセンス
『人事の定量分析』(林 明文)のエッセンスAyumu Kohiyama
 
『人事の定量分析』(林 明文) 「第8章 分析と人事施策」 のエッセンス
『人事の定量分析』(林 明文)「第8章 分析と人事施策」のエッセンス『人事の定量分析』(林 明文)「第8章 分析と人事施策」のエッセンス
『人事の定量分析』(林 明文) 「第8章 分析と人事施策」 のエッセンスAyumu Kohiyama
 
2015年4月にまとめた字の本12冊・マンガ18冊のうち、 オススメ3冊をご紹介!
2015年4月にまとめた字の本12冊・マンガ18冊のうち、オススメ3冊をご紹介!2015年4月にまとめた字の本12冊・マンガ18冊のうち、オススメ3冊をご紹介!
2015年4月にまとめた字の本12冊・マンガ18冊のうち、 オススメ3冊をご紹介!Ayumu Kohiyama
 
経過管理と結果管理の仕事の2つの任せ方
経過管理と結果管理の仕事の2つの任せ方経過管理と結果管理の仕事の2つの任せ方
経過管理と結果管理の仕事の2つの任せ方Ayumu Kohiyama
 
『人事の定量分析』(林 明文) 「第5章 人材流動性に関する分析」 のエッセンス
『人事の定量分析』(林 明文) 「第5章 人材流動性に関する分析」のエッセンス『人事の定量分析』(林 明文) 「第5章 人材流動性に関する分析」のエッセンス
『人事の定量分析』(林 明文) 「第5章 人材流動性に関する分析」 のエッセンスAyumu Kohiyama
 
『人事の定量分析』(林 明文)  「第3章 人員数に関する分析」 のエッセンス
『人事の定量分析』(林 明文) 「第3章 人員数に関する分析」のエッセンス『人事の定量分析』(林 明文) 「第3章 人員数に関する分析」のエッセンス
『人事の定量分析』(林 明文)  「第3章 人員数に関する分析」 のエッセンスAyumu Kohiyama
 
『人事の定量分析』(林 明文) /「第2章 人件費関連分析」 のエッセンス
『人事の定量分析』(林 明文)/「第2章 人件費関連分析」のエッセンス『人事の定量分析』(林 明文)/「第2章 人件費関連分析」のエッセンス
『人事の定量分析』(林 明文) /「第2章 人件費関連分析」 のエッセンスAyumu Kohiyama
 
『人事の定量分析』(林 明文)  「第1章 人事を合理的・科学的にするための定量分析」 のエッセンス
『人事の定量分析』(林 明文) 「第1章 人事を合理的・科学的にするための定量分析」のエッセンス『人事の定量分析』(林 明文) 「第1章 人事を合理的・科学的にするための定量分析」のエッセンス
『人事の定量分析』(林 明文)  「第1章 人事を合理的・科学的にするための定量分析」 のエッセンスAyumu Kohiyama
 
模擬国連を通して学べることを考えてみた
模擬国連を通して学べることを考えてみた模擬国連を通して学べることを考えてみた
模擬国連を通して学べることを考えてみたAyumu Kohiyama
 
2015年2月にまとめた字の本12冊・マンガ15冊のうち、 オススメベスト5をご紹介!
2015年2月にまとめた字の本12冊・マンガ15冊のうち、オススメベスト5をご紹介!2015年2月にまとめた字の本12冊・マンガ15冊のうち、オススメベスト5をご紹介!
2015年2月にまとめた字の本12冊・マンガ15冊のうち、 オススメベスト5をご紹介!Ayumu Kohiyama
 
プロフェッショナル要件定義の教科書』の内容が 要件定義を考える上で大切だったのでまとめてみた
プロフェッショナル要件定義の教科書』の内容が要件定義を考える上で大切だったのでまとめてみたプロフェッショナル要件定義の教科書』の内容が要件定義を考える上で大切だったのでまとめてみた
プロフェッショナル要件定義の教科書』の内容が 要件定義を考える上で大切だったのでまとめてみたAyumu Kohiyama
 
『人材育成の教科書』(高原 暢恭)の内容が 人事、特に研修の基礎知識として 参考になりそうなのでまとめてみた
『人材育成の教科書』(高原 暢恭)の内容が人事、特に研修の基礎知識として参考になりそうなのでまとめてみた『人材育成の教科書』(高原 暢恭)の内容が人事、特に研修の基礎知識として参考になりそうなのでまとめてみた
『人材育成の教科書』(高原 暢恭)の内容が 人事、特に研修の基礎知識として 参考になりそうなのでまとめてみたAyumu Kohiyama
 
『機械との競争』(エリク ブリニョルフソン)の 内容がコンピュータと人間の関係の これからを感じさせたのでまとめてみた
『機械との競争』(エリク ブリニョルフソン)の内容がコンピュータと人間の関係のこれからを感じさせたのでまとめてみた『機械との競争』(エリク ブリニョルフソン)の内容がコンピュータと人間の関係のこれからを感じさせたのでまとめてみた
『機械との競争』(エリク ブリニョルフソン)の 内容がコンピュータと人間の関係の これからを感じさせたのでまとめてみたAyumu Kohiyama
 
『人事管理入門』(日経文庫) 今野 浩一郎 (著) のエッセンス
『人事管理入門』(日経文庫) 今野 浩一郎  (著) のエッセンス『人事管理入門』(日経文庫) 今野 浩一郎  (著) のエッセンス
『人事管理入門』(日経文庫) 今野 浩一郎 (著) のエッセンスAyumu Kohiyama
 
『これからはじめるプログラミング基礎の基礎』 のエッセンス
『これからはじめるプログラミング基礎の基礎』 のエッセンス『これからはじめるプログラミング基礎の基礎』 のエッセンス
『これからはじめるプログラミング基礎の基礎』 のエッセンスAyumu Kohiyama
 
2014年1月にまとめた40冊からおススメ8冊(活字5冊・マンガ3冊)
2014年1月にまとめた40冊からおススメ8冊(活字5冊・マンガ3冊)2014年1月にまとめた40冊からおススメ8冊(活字5冊・マンガ3冊)
2014年1月にまとめた40冊からおススメ8冊(活字5冊・マンガ3冊)Ayumu Kohiyama
 
ブログにまとめた37冊の中からオススメのマンガ3冊!(2013年12月)
ブログにまとめた37冊の中からオススメのマンガ3冊!(2013年12月)ブログにまとめた37冊の中からオススメのマンガ3冊!(2013年12月)
ブログにまとめた37冊の中からオススメのマンガ3冊!(2013年12月)Ayumu Kohiyama
 
人事改革ビジネス小説に出てきた人事に関するいくつかのお話
人事改革ビジネス小説に出てきた人事に関するいくつかのお話人事改革ビジネス小説に出てきた人事に関するいくつかのお話
人事改革ビジネス小説に出てきた人事に関するいくつかのお話Ayumu Kohiyama
 
「あいつは、信頼出来ない」と言うことについて。
「あいつは、信頼出来ない」と言うことについて。「あいつは、信頼出来ない」と言うことについて。
「あいつは、信頼出来ない」と言うことについて。Ayumu Kohiyama
 

Mais de Ayumu Kohiyama (20)

『人事の定量分析』(林 明文)のエッセンス
『人事の定量分析』(林 明文)のエッセンス『人事の定量分析』(林 明文)のエッセンス
『人事の定量分析』(林 明文)のエッセンス
 
『人事の定量分析』(林 明文) 「第8章 分析と人事施策」 のエッセンス
『人事の定量分析』(林 明文)「第8章 分析と人事施策」のエッセンス『人事の定量分析』(林 明文)「第8章 分析と人事施策」のエッセンス
『人事の定量分析』(林 明文) 「第8章 分析と人事施策」 のエッセンス
 
2015年4月にまとめた字の本12冊・マンガ18冊のうち、 オススメ3冊をご紹介!
2015年4月にまとめた字の本12冊・マンガ18冊のうち、オススメ3冊をご紹介!2015年4月にまとめた字の本12冊・マンガ18冊のうち、オススメ3冊をご紹介!
2015年4月にまとめた字の本12冊・マンガ18冊のうち、 オススメ3冊をご紹介!
 
経過管理と結果管理の仕事の2つの任せ方
経過管理と結果管理の仕事の2つの任せ方経過管理と結果管理の仕事の2つの任せ方
経過管理と結果管理の仕事の2つの任せ方
 
『人事の定量分析』(林 明文) 「第5章 人材流動性に関する分析」 のエッセンス
『人事の定量分析』(林 明文) 「第5章 人材流動性に関する分析」のエッセンス『人事の定量分析』(林 明文) 「第5章 人材流動性に関する分析」のエッセンス
『人事の定量分析』(林 明文) 「第5章 人材流動性に関する分析」 のエッセンス
 
『人事の定量分析』(林 明文)  「第3章 人員数に関する分析」 のエッセンス
『人事の定量分析』(林 明文) 「第3章 人員数に関する分析」のエッセンス『人事の定量分析』(林 明文) 「第3章 人員数に関する分析」のエッセンス
『人事の定量分析』(林 明文)  「第3章 人員数に関する分析」 のエッセンス
 
『人事の定量分析』(林 明文) /「第2章 人件費関連分析」 のエッセンス
『人事の定量分析』(林 明文)/「第2章 人件費関連分析」のエッセンス『人事の定量分析』(林 明文)/「第2章 人件費関連分析」のエッセンス
『人事の定量分析』(林 明文) /「第2章 人件費関連分析」 のエッセンス
 
『人事の定量分析』(林 明文)  「第1章 人事を合理的・科学的にするための定量分析」 のエッセンス
『人事の定量分析』(林 明文) 「第1章 人事を合理的・科学的にするための定量分析」のエッセンス『人事の定量分析』(林 明文) 「第1章 人事を合理的・科学的にするための定量分析」のエッセンス
『人事の定量分析』(林 明文)  「第1章 人事を合理的・科学的にするための定量分析」 のエッセンス
 
模擬国連を通して学べることを考えてみた
模擬国連を通して学べることを考えてみた模擬国連を通して学べることを考えてみた
模擬国連を通して学べることを考えてみた
 
2015年2月にまとめた字の本12冊・マンガ15冊のうち、 オススメベスト5をご紹介!
2015年2月にまとめた字の本12冊・マンガ15冊のうち、オススメベスト5をご紹介!2015年2月にまとめた字の本12冊・マンガ15冊のうち、オススメベスト5をご紹介!
2015年2月にまとめた字の本12冊・マンガ15冊のうち、 オススメベスト5をご紹介!
 
プロフェッショナル要件定義の教科書』の内容が 要件定義を考える上で大切だったのでまとめてみた
プロフェッショナル要件定義の教科書』の内容が要件定義を考える上で大切だったのでまとめてみたプロフェッショナル要件定義の教科書』の内容が要件定義を考える上で大切だったのでまとめてみた
プロフェッショナル要件定義の教科書』の内容が 要件定義を考える上で大切だったのでまとめてみた
 
『人材育成の教科書』(高原 暢恭)の内容が 人事、特に研修の基礎知識として 参考になりそうなのでまとめてみた
『人材育成の教科書』(高原 暢恭)の内容が人事、特に研修の基礎知識として参考になりそうなのでまとめてみた『人材育成の教科書』(高原 暢恭)の内容が人事、特に研修の基礎知識として参考になりそうなのでまとめてみた
『人材育成の教科書』(高原 暢恭)の内容が 人事、特に研修の基礎知識として 参考になりそうなのでまとめてみた
 
『機械との競争』(エリク ブリニョルフソン)の 内容がコンピュータと人間の関係の これからを感じさせたのでまとめてみた
『機械との競争』(エリク ブリニョルフソン)の内容がコンピュータと人間の関係のこれからを感じさせたのでまとめてみた『機械との競争』(エリク ブリニョルフソン)の内容がコンピュータと人間の関係のこれからを感じさせたのでまとめてみた
『機械との競争』(エリク ブリニョルフソン)の 内容がコンピュータと人間の関係の これからを感じさせたのでまとめてみた
 
『人事管理入門』(日経文庫) 今野 浩一郎 (著) のエッセンス
『人事管理入門』(日経文庫) 今野 浩一郎  (著) のエッセンス『人事管理入門』(日経文庫) 今野 浩一郎  (著) のエッセンス
『人事管理入門』(日経文庫) 今野 浩一郎 (著) のエッセンス
 
『これからはじめるプログラミング基礎の基礎』 のエッセンス
『これからはじめるプログラミング基礎の基礎』 のエッセンス『これからはじめるプログラミング基礎の基礎』 のエッセンス
『これからはじめるプログラミング基礎の基礎』 のエッセンス
 
130302 book
130302 book130302 book
130302 book
 
2014年1月にまとめた40冊からおススメ8冊(活字5冊・マンガ3冊)
2014年1月にまとめた40冊からおススメ8冊(活字5冊・マンガ3冊)2014年1月にまとめた40冊からおススメ8冊(活字5冊・マンガ3冊)
2014年1月にまとめた40冊からおススメ8冊(活字5冊・マンガ3冊)
 
ブログにまとめた37冊の中からオススメのマンガ3冊!(2013年12月)
ブログにまとめた37冊の中からオススメのマンガ3冊!(2013年12月)ブログにまとめた37冊の中からオススメのマンガ3冊!(2013年12月)
ブログにまとめた37冊の中からオススメのマンガ3冊!(2013年12月)
 
人事改革ビジネス小説に出てきた人事に関するいくつかのお話
人事改革ビジネス小説に出てきた人事に関するいくつかのお話人事改革ビジネス小説に出てきた人事に関するいくつかのお話
人事改革ビジネス小説に出てきた人事に関するいくつかのお話
 
「あいつは、信頼出来ない」と言うことについて。
「あいつは、信頼出来ない」と言うことについて。「あいつは、信頼出来ない」と言うことについて。
「あいつは、信頼出来ない」と言うことについて。
 

『リーダブルコード』(Dustin Boswell)に出てきたコードへのコメント記述のポイント