{"id":69,"date":"2004-09-16T04:33:00","date_gmt":"2004-09-16T04:33:00","guid":{"rendered":"http:\/\/sumankumar.com\/blog\/?p=69"},"modified":"2004-09-16T04:33:00","modified_gmt":"2004-09-16T04:33:00","slug":"travails-of-a-tech-writer","status":"publish","type":"post","link":"https:\/\/sumankumar.com\/blog\/2004\/09\/travails-of-a-tech-writer\/","title":{"rendered":"Travails of a tech writer"},"content":{"rendered":"<p>Lot of people ask me what I do for a living. When I say &#8216;Tech writer.&#8217; they go, &#8216;What&#8217;s that?&#8217;. And I explain,<br \/>\n<br \/>&#8216;What do you do when you are stuck with MS-Word or Excel?&#8217;<br \/>\n<br \/>&#8216;Call the guy that sold me the computer?&#8217;<br \/>\n<br \/>And I&#8217;d hide my exasperation and pain,<br \/>\n<br \/>&#8216;No, I mean, it is 2 a.m. and you can&#8217;t call anyone.&#8217;<br \/>\n<br \/>&#8216;What&#8217;s the big deal? I&#8217;ll call the next morning, but hey,you haven&#8217;t told me what you do as a tech writer man.&#8217;<br \/>\n<br \/>And I&#8217;d resign saying, &#8216;I write help. Like when you hit F1 on MS-Word, you know?&#8217; And my audience would groan, &#8216;ohhhh! Never read that stuff.&#8217; A pause. And, &#8216;Is that it?&#8217;<br \/>\n<br \/>There. Do you see my misery?<br \/>\n<br \/>My audience includes lay people, software engineers, undertakers, tea-tasters, musicians, and my dad. Phew. All you guys, read this:<br \/>\n<\/p>\n<blockquote><p>God I hate writing help files. I&#8217;ll never be able to be a technical writer. How do those people do it? There are actually technical writing sites that are devoted to the love of the profession. I seriously admire these people. It takes nothing but love and hard work to be good at this (much like C++..?). And all I&#8217;m trying to do is make a simple help file on The Regulator. Geez. You&#8217;d think I&#8217;d have done it by now, 4 days after starting, but no. I only have like one page and a basket full of chocolate wrappings(kidding&#8230; we&#8217;re trying to have the least amount of chocolate available in the house, specifically for situations such as this). So. any suggestions? anyone else wants to help me write this thing? I promise a serious credit in the about \ud83d\ude42<\/p>\n<p>To be honest, I&#8217;ve never had to do this before. Sure, I&#8217;ve written many technical documents, but documents that say \u201cclick this then you&#8217;lll see this so click that to get this\u201d are simply &#8230;.ugh!<\/p><\/blockquote>\n<p> (via <a href=\"http:\/\/weblogs.asp.net\/rosherove\/archive\/2003\/11\/12\/37085.aspx\">rosherove<\/a>)<\/p>\n<p>Write to me: Suman[at]techwritersindia[dot]com<\/p>\n<div class=\"blogger-post-footer\">\n<map name=\"google_ad_map_061219083750040916043300\">\n<area shape=\"rect\" href=\"http:\/\/imageads.googleadservices.com\/pagead\/imgclick\/061219083750040916043300?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_061219083750040916043300\" 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=061219083750040916043300&amp;url=http%3A%2F%2Ftw-india.blogspot.com%2F2004%2F09%2Ftravails-of-tech-writer.html\"\/><\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Lot of people ask me what I do for a living. When I say &#8216;Tech writer.&#8217; they go, &#8216;What&#8217;s that?&#8217;. And I explain, &#8216;What do you do when you are stuck with MS-Word or Excel?&#8217; &#8216;Call the guy that sold me the computer?&#8217; And I&#8217;d hide my exasperation and pain, &#8216;No, I mean, it is [&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-69","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":1,"uagb_excerpt":"Lot of people ask me what I do for a living. When I say &#8216;Tech writer.&#8217; they go, &#8216;What&#8217;s that?&#8217;. And I explain, &#8216;What do you do when you are stuck with MS-Word or Excel?&#8217; &#8216;Call the guy that sold me the computer?&#8217; And I&#8217;d hide my exasperation and pain, &#8216;No, I mean, it is&hellip;","jetpack_shortlink":"https:\/\/wp.me\/p2Gbk8-17","jetpack_likes_enabled":false,"jetpack_sharing_enabled":true,"jetpack-related-posts":[{"id":34,"url":"https:\/\/sumankumar.com\/blog\/2003\/08\/34\/","url_meta":{"origin":69,"position":0},"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":88,"url":"https:\/\/sumankumar.com\/blog\/2005\/09\/tech-writer-or-dtp-expert\/","url_meta":{"origin":69,"position":1},"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":57,"url":"https:\/\/sumankumar.com\/blog\/2004\/05\/opportunity-tech-writer-for-developing-dictionary-of-terms\/","url_meta":{"origin":69,"position":2},"title":"Opportunity: Tech writer for developing dictionary of terms","author":"Suman Kumar","date":"May 20, 2004","format":false,"excerpt":"Tore Nestenius is looking for a good tenchical writer who can help write a kind of dictionary for software development terms and computer hardware terms. Where terms\/words are explained. Interested? Rush your mail to synchron(at)algonet(dot)se . Write to me: Suman[at]techwritersindia[dot]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":44,"url":"https:\/\/sumankumar.com\/blog\/2003\/11\/44\/","url_meta":{"origin":69,"position":3},"title":"How to become a technical\u2026","author":"Suman Kumar","date":"November 24, 2003","format":false,"excerpt":"How to become a technical writer I got a few mails from aspiring tech writers asking how to be a technical writer. I'll assume that you guys are asking me 'how to get a technical writer's job'. Please note that the content below is inspired by what little I know;\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":183,"url":"https:\/\/sumankumar.com\/blog\/2003\/01\/183\/","url_meta":{"origin":69,"position":4},"title":"Technical writing: Mail from the\u2026","author":"Suman Kumar","date":"January 5, 2003","format":false,"excerpt":"Technical writing: Mail from the TWIN list Someone had mailed to the list asking for info on tech writing training institutes. I responded and thought should blog it too - Suman Hi uma shankar, Sorry to tell you that there are no formal training institutes for tech writing in India\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":75,"url":"https:\/\/sumankumar.com\/blog\/2004\/12\/firefox-tech-writer-friendly\/","url_meta":{"origin":69,"position":5},"title":"Firefox: Tech writer friendly!","author":"Suman Kumar","date":"December 9, 2004","format":false,"excerpt":"Firefox has an in-built popup blocker. Firefox saves your screenspace through its tabbed-browsing feature. Firefox allows for opening multiple sites using tabs (within one instance), unlike IE that opens a separate instance of the browser everytime you open a new window. What it means is that you could be browsing\u2026","rel":"","context":"In \"Uncategorized\"","block_context":{"text":"Uncategorized","link":"https:\/\/sumankumar.com\/blog\/tag\/uncategorized\/"},"img":{"alt_text":"Get Firefox","src":"http:\/\/www.mozilla.org\/products\/firefox\/buttons\/getfirefox_large.png","width":350,"height":200},"classes":[]}],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/sumankumar.com\/blog\/wp-json\/wp\/v2\/posts\/69","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=69"}],"version-history":[{"count":0,"href":"https:\/\/sumankumar.com\/blog\/wp-json\/wp\/v2\/posts\/69\/revisions"}],"wp:attachment":[{"href":"https:\/\/sumankumar.com\/blog\/wp-json\/wp\/v2\/media?parent=69"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/sumankumar.com\/blog\/wp-json\/wp\/v2\/categories?post=69"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/sumankumar.com\/blog\/wp-json\/wp\/v2\/tags?post=69"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}