Funny Quotes: If a program is useful, it will have to be changed. ... If a program is useless, it will have to be documented.
We do not want our (end-user) documentation to be too clear. We make a lot of money doing training. Real programmers don't comment their code, if it was hard to write, it should be hard to understand and harder to modify Real programmers don't document their programs. Documentation is for simpletons who can't read listings or the object code from dumps. Rule 1 of writing software for nontechnical users is this: if they have to read documentation to use it you designed it wrong. Voluminous documentation is part of the problem, not part of the solution. Documentation is like sex: when it is good, it is very, very good; and when it is bad, it is better than nothing Dave -----Original Message----- From: ProFox [mailto:profox-boun...@leafe.com] On Behalf Of Alan Bourke Sent: 31 October 2013 15:18 To: profox@leafe.com Subject: Re: Is code self documenting? On Thu, Oct 31, 2013, at 02:05 PM, Virgil Bierschwale wrote: > > Wonder how many systems are out there like that > A lot. A lot a lot. [excessive quoting removed by server] _______________________________________________ Post Messages to: ProFox@leafe.com Subscription Maintenance: http://mail.leafe.com/mailman/listinfo/profox OT-free version of this list: http://mail.leafe.com/mailman/listinfo/profoxtech Searchable Archive: http://leafe.com/archives/search/profox This message: http://leafe.com/archives/byMID/profox/18725b8cd2d5d247873a2baf401d4ab22a40c...@ex2010-a-fpl.fpl.LOCAL ** All postings, unless explicitly stated otherwise, are the opinions of the author, and do not constitute legal or medical advice. This statement is added to the messages for those lawyers who are too stupid to see the obvious.
