| Technical Communication and Programming: Using Writing Rules |
This article is about better commenting practices for the purpose of—perhaps—helping some to better their programming practices. But before beginning, let me qualify the entire thing by saying that I am not a programmer—not the professional kind anyway. I have created small programs in the past for some of my employers, but that is not how I make my living. Therefore, I am not trying to teach principles of programming. I am only a writing teacher who happens to enjoy programming as a hobby. And while I cannot provide insight into better programming principles, I can offer guidance about writing those short pieces of text programmers always embed, but sometimes neglect. Helping students write better documents is, after all, my occupation; and believe it or not the principles I teach to write better papers are not that different from the principles needed to write better code.
|