Free Republic
Browse · Search
General/Chat
Topics · Post Article

To: Tell It Right

Who wants to do the documentation, code review and testing for free? Even a lot of paid engineers would rather not do these steps.


6 posted on 05/08/2025 6:34:29 AM PDT by MulberryDraw
[ Post Reply | Private Reply | To 4 | View Replies ]


To: MulberryDraw
I didn't mean to suggest that documentation and peer review and testing be free. I meant to say that if you don't use freeware, but instead build your code base inhouse (paid workers), then your paid workers must also do documentation and code review so that your knowledge isn't dependent on just one or two people.

When I'd train newbies on how to use my middle tier and lower tier code bases, I'd often use my documentation to do so. I'd tell the other programmer that I'm not trying to leave him high and dry, that I'll train him if necessary. But by him trying to use the documentation first, it told me how well the documentation was written. If the documentation doesn't tell him what he needs to know, then it tells me I need to update my documentation while I'm training him. Thus after years of training people with that approach, we had robust documentation (which eventually included all of the questions I was asked about handling different scenarios).

7 posted on 05/08/2025 6:49:34 AM PDT by Tell It Right (1 Thessalonians 5:21 -- Put everything to the test, hold fast to that which is true.)
[ Post Reply | Private Reply | To 6 | View Replies ]

Free Republic
Browse · Search
General/Chat
Topics · Post Article


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