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 *
|