Comments for AriasAmp http://www.ariasamp.net Brent Arias chanting about software development Thu, 31 Mar 2011 20:02:56 +0000 hourly 1 http://wordpress.org/?v=3.0.3 Comment on A Review of Peer Reviews by Cory Lamle http://www.ariasamp.net/2011/03/review-peer-reviews/comment-page-1/#comment-68 Cory Lamle Thu, 31 Mar 2011 20:02:56 +0000 http://www.ariasamp.net/?p=182#comment-68 Excellent article Brent! The peer-review aspect is really a colossal point that so many developers just don’t do or get well. For me the most desirable outcomes of a good peer-review help generate well written documents or hopefully a clean API (if they were not even considered first), heck even nice clean detailed comments get generated to help further explain the rationale behind the design. Most developers just write code for their own consumption and don’t even think of the various consumers of it (usually their peers). Too many assumptions are made that anyone can just read the code and understand the process. However in larger systems this is not always the case, and following a rabbit trail down a stack that is at minimum a 100 levels deep just isn’t any fun. In an ideal world peer-reviews should be the norm, but either laziness or busyness tends to mask out these much need practices. Excellent article Brent! The peer-review aspect is really a colossal point that so many developers just don’t do or get well. For me the most desirable outcomes of a good peer-review help generate well written documents or hopefully a clean API (if they were not even considered first), heck even nice clean detailed comments get generated to help further explain the rationale behind the design.

Most developers just write code for their own consumption and don’t even think of the various consumers of it (usually their peers). Too many assumptions are made that anyone can just read the code and understand the process. However in larger systems this is not always the case, and following a rabbit trail down a stack that is at minimum a 100 levels deep just isn’t any fun. In an ideal world peer-reviews should be the norm, but either laziness or busyness tends to mask out these much need practices.

]]>