|
|
|

Readers Respond: Making Code Perfectly Clear
By: eWEEK
2006-03-06
Article Rating:    / 0
There are 0 user comments on this Application Development story.
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
|
|
x}ks8q8c"e=lGJɖkcYZK7[HH"$eG|9u _zВIIʶD
th4?I"ftcnQ?sOuޙ'T76{R(%GFgP+N-w5 E]0eNZNv@\ }@^}F7D%x_'Щ=ѩ:wɔiPSoل^͙ۗ6}^~b.hѲ
⌳Il/G
tyG`aZN<1)_NDRB@T4NHXߢر7R=2r3͛6B!|LX^P~D;ǎG{F?=3τPcw
0}dd9-r4=yͰ
{ /\1r.bLѼ[@,gw'9"ScO$ա%UNIp/09Q#@oXS.HTf̴;gj5[gb}ױ}ǣ#3E5L֟GBS If[a(ţ
g?LG`B'lǦ"Gml_j|4v9s8&sz5
wjHU~cnhK Tw<-0;DL=:/DzyÙÌ[~i 퉪JGjP8)VGãx>oچs[=bTyݙkQվH QPwÑٷ@ږkZT`(:n{> Wݏ7~@.{A>odm+5'}&D%\.OfI&0hէ6ttXB,> yd' rtxTTZ, TO$0L"ÌJ3~̢(#dvtД-AwȠuvqzn#,[3SATT̠t?c;Szqsyi_57}r&Yə{F0pgsZk!-/qo,rG=jiT$%fl" }8l$73Yn%0dio,Yn]H.)żMa)(7F`X@7? iP2Z
8oX@/@ש#qtB9::mT3o`2f4.ͻZh-
@ho*KjLr5&@Sk~ $Mcb.L2o2z뤀%/^(P%!P샚_.[
jFՇTwPH7#DD vxr!DKI88c^IRe1\ni>U<<}vwެu*մޅ-~aށؓy1pj~{Nokǫg%",$ꨦVG}<#p{ hS2e8l2nб6_@5ti3|>9Fm'!|Аd
mx=Z.3I Xn`thWX8<cOv/|\aPn-j$
>6(Zχ`j˦Mf@B9{ǻޚA<QБ4|aqjQ?]*~hs-w= }
wA,s6Gv62-0sť6F\KQ?zdQJ$@!-i] R@Az6W?-8,rr $QzGBJ0iJlRi KgRKx&,QY,p[/ ͙JRdUu Q="`&Qea*0pDKak`FZ<<,Q
NhқM݄%1@μs2H`0HCb;NM: x91!v<;%t0fXfZ1k`JaǺ@2iI3ӆԧ$rTDhL˄r=6`\2'45K\wıa漇dN'p6?>y@M\n|8$o4<3_N#k[} J|z[.z:
%r%
5kb$T`CfL
yrpm
OTXbZO9XScX`D~wLzb8ufm/n$)`V|\uLg˦zkfTؽ/ 7R@^֥PJ
M2LZ1D4$B]`}.eGQHīl-
6:6pȞc}nP
rQGG,-3ȃXJ<6k|-[Y`C aPeܡ)5$XsQ_ي-ri˰7bzgAs,C[fl2n:
{y4!%2$N?&BXiS
@%ZZ`"o lX.~j"yd\8˰De9F3v,˹Ϧd^0RJc hxhDssDb8"T2paLHǎ73M#đavSm&v"5Dw MJm[̜֥gbQIBnuB9)` L` T<5&{;
7G\d`АB(r\Q-W0"s
ZE疢`d$܌wт.[|X]OҶ@eЧCjzq~ᇆ9*#'hho?^HjX&ZVRPT*8Y+0ϹoǼN]Cg<8k!yw꾽g4j
cѐPz;1|;CzڂeXY1f-1_0Eu/G,9+ifaL['ɂX&
,$W2h:pn`wy @L0ECf0% L6Ѧ1&o<<+jZ#U&5b34JmӹBg@LsZ0f^SL?5P9gj/J.4F@2( #s]QYRm2o 7ثէόE欭h+RSJb/$6a!L";띭_Qm(}nLZ{myt:|8'kZ}2p7v Aūm#52镍0:M}GQWT@a0&3(g=HY9a+o4=1۠OFzT4A7(WBM)nx m_>L};L4;&.E;"qfDdkŎrH=(RPc0:u
Wh+0J[6`^.]>lf#g<,Qhn1]
>qD
v-T`55#x (.}*
r,*H-ů i3FɁ㚺/ksO3v8F?0jịV3#)Ьڴ#i@/F=u=pDoTC*mT)N~ޓJtL q]C0
aE)ݣ,P.|arR |