Comments on: Guide to technical writing http://www.mehtanirav.com/2007/05/16/guide-to-technical-writing Nirav Mehta on life, technology and future Sun, 14 Mar 2010 02:18:22 +0000 http://wordpress.org/?v=2.9.2 hourly 1 By: Technical Writing Geek http://www.mehtanirav.com/2007/05/16/guide-to-technical-writing/comment-page-1#comment-121922 Technical Writing Geek Wed, 23 Jan 2008 22:19:26 +0000 http://www.mehtanirav.com/2007/05/16/guide-to-technical-writing/#comment-121922 Good list of resources. I've got a few more at my website, but here's my number one beef with bad technical writing: Make sure what you're saying is relevant. Are you helping the user get anywhere, or filling the page with repetitive verbiage? Manuals should be as short as possible, and have real information to offer. The worst mistake is to make tautological text: News finder. This widget helps you find news. If you're looking for news, use the news finder to locate news. WTF Good list of resources. I’ve got a few more at my website, but here’s my number one beef with bad technical writing:

Make sure what you’re saying is relevant. Are you helping the user get anywhere, or filling the page with repetitive verbiage?

Manuals should be as short as possible, and have real information to offer. The worst mistake is to make tautological text:

News finder. This widget helps you find news. If you’re looking for news, use the news finder to locate news.

WTF

]]> By: Arun Bagul http://www.mehtanirav.com/2007/05/16/guide-to-technical-writing/comment-page-1#comment-66582 Arun Bagul Mon, 21 May 2007 05:16:06 +0000 http://www.mehtanirav.com/2007/05/16/guide-to-technical-writing/#comment-66582 This is really help ful for me. I too bad in writing specially email and general writing in english. Thank you, Arun This is really help ful for me.
I too bad in writing specially email and general writing in english.
Thank you,
Arun

]]> By: sheetal http://www.mehtanirav.com/2007/05/16/guide-to-technical-writing/comment-page-1#comment-65835 sheetal Fri, 18 May 2007 09:51:07 +0000 http://www.mehtanirav.com/2007/05/16/guide-to-technical-writing/#comment-65835 hey that piece of information looks really helpfull, specially when somebody like me aspires to write but feels handicapped without the basics.Will defntly have my hands on one of those.Thanks. hey that piece of information looks really helpfull, specially when somebody like me aspires to write but feels handicapped without the basics.Will defntly have my hands on one of those.Thanks.

]]>