Free Republic
Browse · Search
News/Activism
Topics · Post Article

To: palmer
formality is not always a bad thing. One thing that I've noticed over the years is that our programmers really neglect any sort of formal documentation of their work. Thats really my only complaint with the code(aside from poor architecture, and reusability) This may ensure their jobs for the short term, but it also hampers efficiency, the Indian engineers are really anal about documentation, they usually document every little detail of a project to death, but it helps.
141 posted on 09/22/2002 7:05:12 PM PDT by ComputationalComplexity
[ Post Reply | Private Reply | To 140 | View Replies ]


To: ComputationalComplexity
It may be a cliche, but good code documents itself.
142 posted on 09/22/2002 7:08:57 PM PDT by palmer
[ Post Reply | Private Reply | To 141 | View Replies ]

To: ComputationalComplexity
This may ensure their jobs for the short term, but it also hampers efficiency, the Indian engineers are really anal about documentation, they usually document every little detail of a project to death, but it helps.

Now I have heard everything. Most Indian software engineers on H-1B visa's can hardly even send email without major grammatical errors. A lot of good companies are ISO certified and require documentation as a part of the engineering process. Writing documentation is always a scheduled item and if a manager does not want it done then it does not get done and vice versa.

149 posted on 09/22/2002 7:25:04 PM PDT by blueriver
[ Post Reply | Private Reply | To 141 | View Replies ]

To: ComputationalComplexity
That's the opposite of what I saw. The Indian engineers had code that worked, but it was usually spaghetti code and undocumented. If you needed to change it for some reason, good luck.
188 posted on 09/22/2002 10:25:10 PM PDT by luckystarmom
[ Post Reply | Private Reply | To 141 | View Replies ]

Free Republic
Browse · Search
News/Activism
Topics · Post Article


FreeRepublic, LLC, PO BOX 9771, FRESNO, CA 93794
FreeRepublic.com is powered by software copyright 2000-2008 John Robinson