Re: Flow chart generators

On Mon, 26 Oct 2009 14:45:22 -0500, "HeyBub" <heybub@xxxxxxxxxxxxxxx>
wrote:

Well, admittedly, the Data Division is not self-documenting, but that can be
solved by the liberal application of COPY books.

Very good.

I was thinking about CoBOL's self-documenting characteristic.

All code in any? language can be documented. But the best
documentation is that which is up-to-date and trustworthy. This is
pretty obvious, but how many shops guarantee that text documentation
is trustworthy?

If we programmers have to document anyway, it is preferable to have
documentation tied to the code. Meaningful names doesn't take more
effort than comments. Designing code to be read isn't that hard.

Of course, if documentation isn't our thing, we can write cryptic,
disposable code.

--
"In no part of the constitution is more wisdom to be found,
than in the clause which confides the question of war or peace
to the legislature, and not to the executive department."

- James Madison
.

Relevant Pages

  • Re: accessing database problem
    ... What language are you using? ... Have you read any books or documentation on the subject? ... > therefore i have a guestion - i installed visual studio and according ...
    (microsoft.public.dotnet.framework.adonet)
  • Re: Is Ruby For Me?
    ... 'Programming Ruby'. ... then it might as well not be part of the language. ... Granted, I would like more formal forms of documentation, (I admit it, ... Now the *quantity* of Ruby books may not be as great as that of Java, Perl, Python, or PHP, but the *quality* is first-rate. ...
    (comp.lang.ruby)
  • Re: Books Galore - except Delphi
    ... If a language is difficult or impossible to learn, people need lots of books to get a grasp of understanding it. ... Plenty of VB though. ... Now I see a need to get some documentation of the new possibilities, ...
    (borland.public.delphi.non-technical)
  • Re: access(FULLPATH, xxx);
    ... with "trial& error" to just silence the compiler. ... void *foo); ... given that the language in the specification _was_ abiguous and both ... documentation was paramount. ...
    (freebsd-questions)
  • Re: If you were developing a database in Forth...
    ... similar application and provided source and documentation, ... somebody tried to do the same thing in some other language and it ... newsgroup where people are telling real war stories. ... US Marines. ...
    (comp.lang.forth)