Browse by Tags

Technical Documentation, like Code, does not follow English rules for grammar and style
Sat, Aug 1 2009 23:03

The purpose of technical documentation is to precisely convey information to other people who possess the technical skills needed to apply it.  It is not to pass along technical skills, although reading technical documentation on a system designed by someone more experienced often will.  It is not to explain a system to management to enable their decision... Read More...

by Ben Voigt | with no comments

Filed under: food for thought, compsci, sw development

Pride
Fri, Jul 10 2009 20:46

We now interrupt our regularly scheduled engineering to bring you an example of how NOT to lower expectations:   But they must not have thought they were winning the brag-on-your-product competition, because the reverse side of the box steps up to bat AGAIN:   I'm going to finish this post with my old keyboard just in case the new one refuses to... Read More...

by Ben Voigt | with no comments

Filed under: food for thought

Compromising Safety
Wed, Jul 8 2009 23:42

Hey, the catchy title must have worked because you're reading this post.  It is a little misleading though.  This post is about compromises and safety, but it's the compromises made to achieve safety.  If you ever see any feature of this system that appears it might compromise safety, please let me know! I feel a need to explain why the... Read More...

by Ben Voigt | with no comments

Filed under: valve timer, safety, food for thought