Readers Respond: Making Code Perfectly Clear

Home

Application Development

	LATEST STORIES
	- Debunking Microsoft Search Rumors - Flaw Endangers Debian-based Encryption Keys - Old User Accounts Pose Current Security Risk... - Geography as IT Job Destiny - BlackBerry, iPhone Raise Mobile Stakes

	BEST OF THE BLOGOSPHERE
	BlogRovr Acquired by BuzzLogic Understanding Infrastructure FriendFeedMachine Debuts New Approach Google: Same Story - Weak Paid Links Prioritize Feeds: Newsgator Integrates AideRSS

	eWEEK EDITORIAL CALENDAR
	For a list of what eWEEK is covering this year, go to our editorial calendar.


	Killing Botnets: A View From the Trenches from McAfee Using Security Compliance Software to Improve Business Efficiency and Reduce Costs from Symantec Using Web Conferencing to Ensure Successful Enterprise Application Deployment from WebEx Communications See All White Papers >


	Remote Support How to Profit with Remote Support May 8, 2 p.m. ET Your prospects are sourcing new services at an ever increasing rate, which gives you the opportunity to stand out! In order to seize this opportunity, you need compelling IT services that support core business needs, are high value, drive profits and are cost effective to deliver. Join this eSeminar and learn how to structure and manage services to expand your customer base. Register now, attend live or view on-demand! Register Now

News Rotator

End Point Security Choices

Virtual Appliances for VAR's

Securing Mobile Data

Five Steps to Unified Communications

Sponsored by

Related Ads

Application Development

Readers Respond: Making Code Perfectly Clear
By eWEEK
2006-03-06

Article Views: 209
Article Rating:

/ 0

Rate This Article:

Add This Article To:

Digg this

Del.icio.us

Slashdot

Y! My Web

E-mail

Furl

Google

Simpy

Spurl!

PDF Version

Print Version Sponsored By

Readers respond to the eWEEK editorial, "Making Code Perfectly Clear."

I was a programmer for 31 years; I wrote, read, debugged and documented a lot of code during my career. Peter Coffees insights into this subject in his Feb. 6 column, "Making Code Perfectly Clear," are lucid as well as entertaining (Epicenters).

The comments in code can be, and often are, misleading, incomplete or missing, making for very poor documentation. Ive found that it is very common for programmers to not be very good writers of understandable prose.

One of the best programmers I ever worked with was great at writing elegant and accurate code, but if we didnt know what his code was supposed to do, it was useless to read his comments and documentation in our attempt to understand it.

Gary Fancher

	Discuss Readers Respond: Making Code Perfectly Clear

	>>> Be the FIRST to comment on this article!



	>>> More Application Development Articles >>> More By eWEEK

Email Article To Friend ♦ Print Version Of Article ♦ PDF Version Of Article

Print Version Sponsored By

FREE ZIFF DAVIS ENTERPRISE ESEMINARS AT ESEMINARSLIVE.COM

May 13, 11 a.m. ET
Unified Communications and Collaboration Strategy Sponsored by IBM

May 13, 2 p.m. ET
Pricing Managed Services: to SLA or not to SLA with Michael Steinhart. Sponsored by Kaseya

May 13, 3 p.m. ET
Disaster Recovery Planning: Best Practices for Step-by-Step Implementation with Michael Krieger. Sponsored by CA XOsoft

May 14, 11 a.m. ET
Maintaining QoS in an SOA Environment Sponsored by IBM

May 14, 1 p.m. ET
Making Sense of Enterprise SSO with Salvatore Salamone. Sponsored by Actividentity

May 14, 2 p.m. ET
Compliance, PCI and Data Loss: Avoid Worst Case Scenarios with Michael Krieger. Sponsored by Vericept

May 15, 12:30 p.m. ET
Getting OCS Right: Tips for Deployment, Security and Compliance with Michael Krieger. Sponsored by FaceTime & Microsoft

May 15, 2 p.m. ET
SMB Tools for Rapid Recovery: Backup, Archiving & Virtualization with Aaron Goldberg. Sponsored by CDW

More Upcoming Events!

FEATURED CONTENT

IT Failing at Being 'Green'

How to Plan for Disaster Recovery

HP Engineers Claim 'Memristor' Breakthrough

Sponsors

Grow your notebook business today with HP PartnerONE

Symantec Vision 08 – a must event for IT professionals

Defy the laws of reporting with Crystal Reports® 2008.

Microsoft System Center – Designed For Big

Go further, faster with NetApp.

Microsoft Forefront makes defending your systems easier.

Satellite® Pro Series. Feature-packed, business-ready.

Download the “Best Antivirus Product of 2007”

Change your game. With mobility solutions from AT&T.

2008 Internet Security Trends Report

Meet Windows Server 2008. The server unleashed

Introducing BlackBerry® Professional Software from AT&T.

Conference: Transforming Enterprise IT. Register!

VoIP issues? Visit the experts at Global Crossing.

NetFlow Tracker free 7-day trial software – Download Now.

Enter Mobile Web 2.0 - Get your free trial now!

Win a Seagate® Barracuda® 1-TB HDD!

Kaspersky Lab, the new standard in Endpoint Security.

3M saved $3M on printing. Learn how HP can help your business

Videos Sponsored by:

EWEEK E-MAIL NEWSLETTERS bring you reliable, timely information to stay on top of the business of technology -- and technology in business -- and get more out of the Web. Make your choices and start your subscriptions today!

EWEEK RSS NEWS FEEDS contain a daily feed of our latest stories from over 30 different categories including Enterprise Apps, Business Intelligence, Security, VOIP and more!

Subscribe to our RSS feeds today for free...

	Issue Index \| Contact Us \| About \| Advertise \| Magazine Customer Service \| Site Map

	Ziff Davis Enterprise Home \| Contact Us \| Advertise \| Link to Us \| Reprints \| Magazine Subscriptions \| Newsletters Tech RSS Feeds \| White Papers \| ROI Calculators \| Tech Podcasts \| Tech Video \| VARs \| System Builder
	Baseline \| Careers \| Channel Insider \| CIO Insight \| DesktopLinux \| DeviceForge \| DevSource \| eSeminars \| eWEEK \| Enterprise Network Security \| LinuxDevices \| Linux Watch \| Microsoft Watch \| Mid-market \| Networking \| PDF Zone \| Publish \| Security IT Hub \| Strategic Partner \| Web Buyer's Guide \| Windows for Devices
	Developer Shed \| Dev Shed \| ASP Free \| Dev Articles \| Dev Hardware \| SEO Chat \| Tutorialized \| Scripts \| Code Walkers \| Web Hosters \| Dev Mechanic \| Dev Archives \| igrep Use of this site is governed by our Terms of Use and Privacy Policy
	Copyright ©1996-2008 Ziff Davis Enterprise Holdings Inc. All Rights Reserved. eWEEK and Spencer F. Katt are trademarks of Ziff Davis Enterprise Holdings, Inc. Reproduction in whole or in part in any form or medium without express written permission of Ziff Davis Enterprise Inc. is prohibited.

	Issue Index \| Contact Us \| About \| Advertise \| Magazine Customer Service \| Site Map

	Ziff Davis Enterprise Home \| Contact Us \| Advertise \| Link to Us \| Reprints \| Magazine Subscriptions \| Newsletters Tech RSS Feeds \| White Papers \| ROI Calculators \| Tech Podcasts \| Tech Video \| VARs \| System Builder
	Baseline \| Careers \| Channel Insider \| CIO Insight \| DesktopLinux \| DeviceForge \| DevSource \| eSeminars \| eWEEK \| Enterprise Network Security \| LinuxDevices \| Linux Watch \| Microsoft Watch \| Mid-market \| Networking \| PDF Zone \| Publish \| Security IT Hub \| Strategic Partner \| Web Buyer's Guide \| Windows for Devices
	Developer Shed \| Dev Shed \| ASP Free \| Dev Articles \| Dev Hardware \| SEO Chat \| Tutorialized \| Scripts \| Code Walkers \| Web Hosters \| Dev Mechanic \| Dev Archives \| igrep Use of this site is governed by our Terms of Use and Privacy Policy
	Copyright ©1996-2008 Ziff Davis Enterprise Holdings Inc. All Rights Reserved. eWEEK and Spencer F. Katt are trademarks of Ziff Davis Enterprise Holdings, Inc. Reproduction in whole or in part in any form or medium without express written permission of Ziff Davis Enterprise Inc. is prohibited.