{"id":16,"date":"2003-01-23T15:34:00","date_gmt":"2003-01-23T15:34:00","guid":{"rendered":"http:\/\/sumankumar.com\/blog\/?p=16"},"modified":"2003-01-23T15:34:00","modified_gmt":"2003-01-23T15:34:00","slug":"16","status":"publish","type":"post","link":"https:\/\/sumankumar.com\/blog\/2003\/01\/16\/","title":{"rendered":""},"content":{"rendered":"<h3>Role of a Technical Writer: Mail to the TWIN List<\/h3>\n<p>Let&#8217;s look at it the <b>other way around<\/b>. There are still a lot of organizations that do not have a documentation team. It is done as an &#8216;add on&#8217; by the developers themselves. When you have tools like Robohelp, AuthorIT or those little beauties that abound (for free at times), that help you generate .hlp or .chm or xhtml&#8230; developers find &#8216;presenting&#8217; information easier. So I had one of these <b>developer friends <\/b>remarking &#8216;what&#8217;s the big deal man? If I want to I can learn Robohelp in a week&#8217;s time and <b>I can become a tech writer<\/b>.&#8217; I don&#8217;t want to go on about how untrue his statement is. While the temptation to be a jack of all trades is overwhelming, please be warned that, <b>writing as a skill, evolves over years<\/b>. Writers tell stories. Applying this to our profession, <b>we tell stories <\/b>too, on how a product works, or how to troubleshoot something. It is all a story. Forget developers, if being good in a language is a major criterion for becoming a writer, <b>every english professor <\/b>in the world should have churned out best sellers. No sir. No m&#8217;am. Writers write. And it is not easy. Writing well? Oh, that&#8217;s an entirely different story. So the moral is, stick to one profession, focus, and mature, instead of talking about how one can do a million things. Yes one can. But what counts is <b>&#8216;What are you best at?<\/b>&#8216;.<br \/>\n<br \/>Now, talking about QA. In India most companies have a QA cell: Objective: Get those damn certifications. CMM4, 5, six-sigma da da da. Very few are sincere in &#8216;following&#8217; the processes or having a process-driven organization. I have seen many companies get cmm4 now and cmm5 6 months later and something else a year later. Excuse me! My friend working in Prudential told me that they have set up the processes for CMM2, and have been following them for the past few months, but they are very nervous; &#8216;will we get CMM2?&#8217;<br \/>\n<br \/>So if you have any dreams of changing the world by being a part of QA, waky-waky, it could be all a sham pardner. So stick to writing. Focus. If there&#8217;s any profession under the sun that takes decades to master, it is writing. most of us here have been here for what? a few years? We&#8217;ll talk about taking over other domains, after we conquer our own. And on a final note, please learn to discern this: Content from presentation. I see a million mails on FM and CHM, but not so many on the craft itself, writing that is. What gives?<\/p>\n<div class=\"blogger-post-footer\">\n<map name=\"google_ad_map_061219083744030123153400\">\n<area shape=\"rect\" href=\"http:\/\/imageads.googleadservices.com\/pagead\/imgclick\/061219083744030123153400?pos=0\" coords=\"1,2,367,28\"\/>\n<area shape=\"rect\" href=\"http:\/\/services.google.com\/feedback\/abg\" coords=\"384,10,453,23\"\/><\/map>\n<p><img decoding=\"async\" usemap=\"#google_ad_map_061219083744030123153400\" border=\"0\" src=\"http:\/\/imageads.googleadservices.com\/pagead\/ads?format=468x30_aff_img&amp;client=ca-pub-1259014363012020&amp;channel=9138153052&amp;output=png&amp;cuid=061219083744030123153400&amp;url=http%3A%2F%2Ftw-india.blogspot.com%2F2003%2F01%2Frole-of-technical-writer-mail-to-twin.html\"\/><\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Role of a Technical Writer: Mail to the TWIN List Let&#8217;s look at it the other way around. There are still a lot of organizations that do not have a documentation team. It is done as an &#8216;add on&#8217; by the developers themselves. When you have tools like Robohelp, AuthorIT or those little beauties that [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_uag_custom_page_level_css":"","advanced_seo_description":"","jetpack_seo_html_title":"","jetpack_seo_noindex":false,"ngg_post_thumbnail":0,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[1],"tags":[195],"class_list":["post-16","post","type-post","status-publish","format-standard","hentry","category-uncategorized","tag-uncategorized"],"jetpack_featured_media_url":"","uagb_featured_image_src":{"full":false,"thumbnail":false,"medium":false,"medium_large":false,"large":false,"1536x1536":false,"2048x2048":false,"jetpack-portfolio-admin-thumb":false},"uagb_author_info":{"display_name":"Suman Kumar","author_link":"https:\/\/sumankumar.com\/blog\/author\/suman-kumar\/"},"uagb_comment_info":0,"uagb_excerpt":"Role of a Technical Writer: Mail to the TWIN List Let&#8217;s look at it the other way around. There are still a lot of organizations that do not have a documentation team. It is done as an &#8216;add on&#8217; by the developers themselves. When you have tools like Robohelp, AuthorIT or those little beauties that&hellip;","jetpack_shortlink":"https:\/\/wp.me\/s2Gbk8-16","jetpack_likes_enabled":false,"jetpack_sharing_enabled":true,"jetpack-related-posts":[{"id":88,"url":"https:\/\/sumankumar.com\/blog\/2005\/09\/tech-writer-or-dtp-expert\/","url_meta":{"origin":16,"position":0},"title":"Tech writer or DTP Expert?","author":"Suman Kumar","date":"September 5, 2005","format":false,"excerpt":"I saw these requirements for a technical writer opening on one of those \u2018Urgent-wanted tech writers\u2019 mails:HTML programming, JavascriptMicrosoft Office suite (Word, PowerPoint, Excel), Microsoft FrontPageMacromedia DreamweaverMacromedia FlashAdobe Photoshop, Adobe ImageReady, Adobe PageMaker, Adobe Acrobat, RoboHelpMicrosoft VisioI wonder why they left out C, C++, Java, and VisualBasic? Why, why? When\u2026","rel":"","context":"In \"Uncategorized\"","block_context":{"text":"Uncategorized","link":"https:\/\/sumankumar.com\/blog\/tag\/uncategorized\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":35,"url":"https:\/\/sumankumar.com\/blog\/2003\/08\/35\/","url_meta":{"origin":16,"position":1},"title":"Importing Word2000 Documents to RoboHelp\u2026","author":"Suman Kumar","date":"August 13, 2003","format":false,"excerpt":"Importing Word2000 Documents to RoboHelp HTML Article on Robohelp Community Above article in Flash-help format write to me: Suman@sumankumar.com","rel":"","context":"In \"Uncategorized\"","block_context":{"text":"Uncategorized","link":"https:\/\/sumankumar.com\/blog\/tag\/uncategorized\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":196,"url":"https:\/\/sumankumar.com\/blog\/2003\/07\/popular-products-usability\/","url_meta":{"origin":16,"position":2},"title":"Popular Products: Usability","author":"Suman Kumar","date":"July 31, 2003","format":false,"excerpt":"Popular software: Usability Framemaker and Robohelp are a technical writer's tools of the trade. So when I was in a training program early this month (July) I noticed some minor usability problems with them. Framemaker When you open FM for the first time, you'd end up feeling 'why did I\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":34,"url":"https:\/\/sumankumar.com\/blog\/2003\/08\/34\/","url_meta":{"origin":16,"position":3},"title":"How to hire a 'Future-Proof'\u2026","author":"Suman Kumar","date":"August 11, 2003","format":false,"excerpt":"How to hire a 'Future-Proof' Technical Writer I came across quite a few recruitment ads in the papers and job announcements in mailing lists that ask for a technical writer. It is good to see that the demand for my ilk has shot up. What\u2019s appalling though is the emphasis\u2026","rel":"","context":"In \"Uncategorized\"","block_context":{"text":"Uncategorized","link":"https:\/\/sumankumar.com\/blog\/tag\/uncategorized\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":51,"url":"https:\/\/sumankumar.com\/blog\/2004\/03\/localization-and-internationalization\/","url_meta":{"origin":16,"position":4},"title":"Localization and Internationalization","author":"Suman Kumar","date":"March 16, 2004","format":false,"excerpt":"Localization and Internationalization Internationalization: Writing in a neutral, simple language so that the document can be translated to other languages without much trouble. There are standards for it like the The European Association of Aerospace Industries (AECMA) Simplified English. The AECMA Simplified English (SE) dictionary is defined in the AECMA\u2026","rel":"","context":"In \"Uncategorized\"","block_context":{"text":"Uncategorized","link":"https:\/\/sumankumar.com\/blog\/tag\/uncategorized\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":31,"url":"https:\/\/sumankumar.com\/blog\/2003\/08\/a-tale-of-a-technical-writer-who-did-programming-for-fun\/","url_meta":{"origin":16,"position":5},"title":"A Tale of a Technical Writer who did Programming for Fun","author":"Suman Kumar","date":"August 2, 2003","format":false,"excerpt":"A Tale of a Technical Writer who did Programming for FunV Srinivas on the TWIN list wrote:Hello Twinners,I must say I have been keenly following the views and opinions that have been coming up regarding the usage of online help tools.First of all, I would like to say that I\u2026","rel":"","context":"In \"Uncategorized\"","block_context":{"text":"Uncategorized","link":"https:\/\/sumankumar.com\/blog\/tag\/uncategorized\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]}],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/sumankumar.com\/blog\/wp-json\/wp\/v2\/posts\/16","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/sumankumar.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/sumankumar.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/sumankumar.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/sumankumar.com\/blog\/wp-json\/wp\/v2\/comments?post=16"}],"version-history":[{"count":0,"href":"https:\/\/sumankumar.com\/blog\/wp-json\/wp\/v2\/posts\/16\/revisions"}],"wp:attachment":[{"href":"https:\/\/sumankumar.com\/blog\/wp-json\/wp\/v2\/media?parent=16"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/sumankumar.com\/blog\/wp-json\/wp\/v2\/categories?post=16"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/sumankumar.com\/blog\/wp-json\/wp\/v2\/tags?post=16"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}