Thomas Passin wrote:
On Monday, October 17, 2022 at 2:17:35 PM UTC-4 Edward K. Ream wrote:
On Mon, Oct 17, 2022 at 1:16 PM Thomas Passin <[email protected]>
wrote:
I think that the idea that code should be able to communicate
its intent clearly and simply is a good goal. I also think
that there are times when an explanation in a judicious
comment as to why it's being done this way, or what is to be
accomplished, can be very helpful.
Who could argue with that :-)
There seem to be some people who think that code can speak for itself
and need no comments at all. I am not one of them.
Personally, I'm a big proponent of writing the documentation first. Then
filling it in with code. Makes life a lot easier for all concerned -
particularly those who have to deploy & maintain big systems.
Miles Fidelman
--
In theory, there is no difference between theory and practice.
In practice, there is. .... Yogi Berra
Theory is when you know everything but nothing works.
Practice is when everything works but no one knows why.
In our lab, theory and practice are combined:
nothing works and no one knows why. ... unknown
--
You received this message because you are subscribed to the Google Groups
"leo-editor" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/leo-editor/2b1f5805-6104-b7c0-de9c-81ca9b89a4ef%40meetinghouse.net.
