TIP: Click on subject to list as thread! ANSI
echo: quik_bas
to: ALL
from: HARRY HICKEY
date: 1998-03-21 00:46:00
subject: Documenting Code

This is verging towards off-topic, but since lots of folks on this echo
are interested in the matter of code that is documented (vs the other
kind):
  WHEREAS: The great multitude of Programmers consider Documentation a
wearisome and irksome Exercise; and
  WHEREAS: In consequence whereof, a great deal of Source Code goes
forth with little or no Documentation, to the great detriment of those
who would seek to make intelligent use of the aforesaid Code; and
  WHEREAS: The labor supply of qualified Journalists is equal to or
perhaps in excess of demand for their services; and
  WHEREAS: The reverse is true with respect to qualified Programmers;
and
  WHEREAS: The professional training of Journalists is in the skills
of explaining new matters to the Public in a clear, concise, and
readable manner;
  NOW THEREFORE BE IT RESOLVED: That Efforts be undertaken by Software
producers to recruit and cross-train qualified Journalists as
Programmers, to the end that the imbalance in labor supply be
redressed, and the World will be supplied with Programmers who are
habituated to producing Code with appropriate Documentation.
-!-
 þ SLMR 2.1a þ Galactic Dept of Wts & Measures: TAKE US TO YOUR LITER!
---
(1:109/570)
---------------
* Origin: * My Place BBS * 28.8 V.34 * Bowie, Md * (301)805-1602 *

SOURCE: echomail via exec-pc

Email questions or comments to sysop@ipingthereforeiam.com
All parts of this website painstakingly hand-crafted in the U.S.A.!
IPTIA BBS/MUD/Terminal/Game Server List, © 2025 IPTIA Consulting™.