[SATLUG] culture question

Todd W. Bucy toddwbucy at grandecom.net
Mon Aug 4 10:23:56 CDT 2008


On Mon, 2008-08-04 at 10:20 -0500, Borries Demeler wrote:
> > 
> > I am currently writting a paper comaring F/OSS gift economics to that of
> > the Iroquian Wampum system of the 15th and 16th centuries (also a gift
> > economy).  I will not go into all the gory details of my argument, as it
> > largely does not pertain to Linux.  I wrote something that has the ring
> > of "truthiness" and would like to have the communitites opinion on the
> > matter.  comment follows:
> > 
> > "...code that is noted as being “elegant†often requires very little in
> > the way of comments...code which contains to many comments is often
> > thought of as being 'over-designed'..."
> > 
> > I would like to know if this is generally true within the hacker
> > community.  I am by no means a hacker and I am very warry of making such
> > a statement without some confirmation.
> > 
> > Thanks in advance
> > Todd
> 
> I feel it is very good practice to comment code. I do it especially when 
> the algorithm is complicated to explain to the reader (or myself later on)
> the ideas behind the algorithm so it is easier to understand. Commenting
> code saves time for the reader, and it is not at all related to whether the
> code is elegant or over-designed (whatever that is supposed to mean). Even
> very well written code can benefit from clear commenting. In my opinion this
> statement is not useful.
> 
> Regards, -b.
> 

truthiness confimed

Thanks
Todd



More information about the SATLUG mailing list