From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me X-Spam-Level: X-Spam-Status: No, score=-1.3 required=5.0 tests=BAYES_00,INVALID_MSGID autolearn=no autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: fac41,af40e09e753872c X-Google-Attributes: gidfac41,public X-Google-Thread: 109fba,f292779560fb8442 X-Google-Attributes: gid109fba,public X-Google-Thread: f8c65,30e368bdb3310fe5 X-Google-Attributes: gidf8c65,public X-Google-Thread: 103376,30e368bdb3310fe5 X-Google-Attributes: gid103376,public X-Google-Thread: 1014db,30e368bdb3310fe5 X-Google-Attributes: gid1014db,public X-Google-Thread: 10db24,30e368bdb3310fe5 X-Google-Attributes: gid10db24,public X-Google-Thread: 1008e3,30e368bdb3310fe5 X-Google-Attributes: gid1008e3,public From: dewar@cs.nyu.edu (Robert Dewar) Subject: Re: The Last Word on Comments (was Re: Hungarian notation) Date: 1996/06/20 Message-ID: #1/1 X-Deja-AN: 161448003 references: <31bf6e29.185297643@netline-fddi.jpl.nasa.gov> <31C685A1.F1@wgs.estec.esa.nl> <4q79lr$ju5@panix3.panix.com> organization: Courant Institute of Mathematical Sciences newsgroups: comp.lang.ada,comp.lang.c++,comp.lang.c,comp.lang.modula3,comp.lang.modula2,comp.edu,comp.lang.eiffel Date: 1996-06-20T00:00:00+00:00 List-Id: zink@panix said ">My feeling after years of programming is that the only meaningful >documentation a procedure carries are the documentation of its >interface and its evolution, and the code itself." One thing that is interesting in this thread is the extraordinary range of views on this point. It is valuable for everyone to realize that this range exists, because it is fairly important that a project take a reasonably consistent attitude. I certainly would not like zink to be generating comment-free source code anywhere near any of my programs, and no doubt zink would hate my commented code. So this is definitely something to add to interview profiles, and other evaluations!