It’s Time for Your Review



Email    print   
April 15, 2007 —  (Page 1 of 3)
Good writing is an art—one I freely admit I’m still hoping to master even after having earned a living at it for more than 25 years. I’ll write something, read it aloud, make a few changes, read it again, then virtually ball it up for a toss into my recycle bin.

When I get to a point where I think I have something good, I’ll ask one of the other editors or writers nearby to take a look at it, and let me know what they think of the effort. They’ll often show me how I could have eliminated an entire paragraph of explanation with a more elegant turn of phrase higher up in the piece, or that an argument I’m making in a column is disjointed, and that paragraphs need to be rearranged to make the case more clearly or strongly. Or, they simply say, this section here just makes no sense.

Grammar and spelling? Not an issue. Like many of us, I do most of my writing in Microsoft Word, which has great automated tools built in to prevent me from juxtaposing letters in a word, or from mangling my subject/verb agreement. It saves me plenty, believe you me.

But the automated checkers cannot inform me that one well-written sentence could take the place of an entire, clumsily worded paragraph. They can’t tell me that, after scanning the piece from top to bottom, the point I started out to make isn’t the one I delivered at the end.

The same is true for writing software.

There are great automated coding tools that go far beyond auto-completion. They’ll let you know if you’re violating a policy, or if all functional specifications work as desired. But even the best testing tools can’t tell you, for a very simple example, if your code matches up with the documentation, or does what the requirement intended.

And so, at the SD West Conference & Expo held in mid-March in Santa Clara, more than one software company was advocating for the widespread adoption of peer code reviews.




Pages 1 2 3 


Share this link: http://sdt.bz/30435
 
Most Read Latest News Blog Resources

Add comment


Name*
Email*  
Country     


  • Comment
Loading




close
NEXT ARTICLE
Escaping from the “How Long?” time trap
A solid agile implementation requires good time-management and time-tracking skills, which can be hard to develop Read More...
 
 
 
 
News on Monday
more>>
SharePoint Tech Report
more>>


   

 
 

Download Current Issue
FEBRUARY 2012 PDF ISSUE

Need Back Issues?
DOWNLOAD HERE

Want to subscribe?


 
blogs tab
Are you at risk for burnout?
Burnout is a severe problem and it can strike at any time. Here's how to tell if you are nearing the edge.
02/09/2012 02:16 PM EST

Agility, mom, and apple pie
If we're to evaluate the state-of-the-art in software development, we should start with the values espoused in the Agile Manifesto.
02/07/2012 11:57 AM EST

RIM woos developers with free tablet
How do you get more apps ported to the BlackBerry PlayBook? By giving every developer a free tablet, of course!
02/04/2012 01:57 PM EST

GitHire: Use Headhunters to Find Your Perfect Programmer
Are you a hiring manager tired of scouring the job boards? Check out this new service that will find 5 people interested in your jobs.
02/03/2012 12:17 PM EST

Facebook claims hacker cred
Facebook's SEC S-1 filing form includes a short essay on the Hacker Way by Mark Zuckerberg himself.
02/02/2012 08:26 AM EST

Ryan Dahl steps down
Ryan Dahl, creator of Node.js, steps back from his position as gatekeeper for the project.
02/01/2012 04:58 PM EST

 
Events calendar tab
2/13/2012 to 2/16/2012
Santa Clara
TechWeb

2/26/2012 to 2/29/2012
San Francisco
BZ Media

2/27/2012 to 3/2/2012
San Francisco
RSA

3/4/2012 to 3/7/2012
Las Vegas
IBM Tivoli

3/5/2012 to 3/9/2012
San Francisco
TechWeb