TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
I am rewriting a help system written by some other unknown person. I have
another to do as well for this project. I know I am not the only one on this
list who follows modern tech writing standards but I have to tell you
people, this project is making me depressed. The entire project is written
in future tense, there are wishes and desires throughout the project, we
have very complicated sentence structures that use really big words, and
many other problems I must fix. Comma faults and comma splices everywhere.
Dialog boxes are summoned and dismissed! May's all over. Terminates instead
of breaks. Several As mentioned earlier's. In a help file! Like the user
earlier! Like I could find earlier!
I am generally moderate about the certification concept, but if it would
make the really bad writing go away, I am all for it. Then again, this sort
of writing does make many of us a living when we are brought in to fix the
help that none of the users could understand or use.
The next one is 5 times bigger and just as bad. And written by a different
person. sigh. I spend so much time and effort teaching my students how to
write well, and it seems there are a large number of people out there making
apparently a decent living turning out stuff no one can understand. In
future tense with lots of wishing and desiring and other stuff going on. It
Just needed to rant to a few minutes. I have been fixing this 650+ topics
help for 3 days. Getting goofy, I guess.
Happy turkey day everyone!
President of the Inland Empire chapter of the STC
Home of RoboNEWS(tm), the unofficial RoboHELP newsletter
Check out www.WinHelp.net!