<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>PoeWar &#187; Technical Writing</title>
	<atom:link href="http://www.poewar.com/tag/technical-writing/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.poewar.com</link>
	<description>Writing Career Center</description>
	<lastBuildDate>Wed, 04 Jan 2012 06:50:52 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.3.1</generator>
		<item>
		<title>A Career in Technical Writing: Amanda</title>
		<link>http://www.poewar.com/a-career-in-technical-writing-amanda/</link>
		<comments>http://www.poewar.com/a-career-in-technical-writing-amanda/#comments</comments>
		<pubDate>Wed, 20 Aug 2008 15:00:48 +0000</pubDate>
		<dc:creator>John Hewitt</dc:creator>
				<category><![CDATA[Writing]]></category>
		<category><![CDATA[Bullet Points]]></category>
		<category><![CDATA[technical writer]]></category>
		<category><![CDATA[Technical Writing]]></category>
		<category><![CDATA[writer]]></category>

		<guid isPermaLink="false">http://www.poewar.com/?p=4349</guid>
		<description><![CDATA[Bullet Points Third-party personnel recruiters work with companies that are searching for one or more employees. Third-party recruiters work on a commission basis, with the commission typically amounting to about 20 to 25 percent of the employee&#8217;s first-year salary. Third party recruiters are put in the delicate position of having to reconcile two sets of [...]]]></description>
			<content:encoded><![CDATA[<p></p><h3><img class="alignright" style="margin: 5px; float: right;" src="http://www.poewar.com/images/Amanda.jpg" alt="Amanda" width="200" height="194" />Bullet Points</h3>
<ul>
<li>Third-party personnel recruiters work with companies that are searching for one or more employees.</li>
<li>Third-party recruiters work on a commission basis, with the commission typically amounting to about 20 to 25 percent of the employee&#8217;s first-year salary.</li>
<li>Third party recruiters are put in the delicate position of having to reconcile two sets of interests, those of the company and those of the candidate. In most cases, the interests of the company win out because the company is the one that pays the recruiter.</li>
<li>Third party recruiters often have specialties, such as finding executives or technical employees. They may even specialize in very specific niches such as finding C++ programmers or engineers with government security clearances.</li>
<li>Never work with an employment agency that charges you a fee.</li>
<li>The song Amanda, by the band Boston, was their biggest hit. It reached number one on the singles chart in 1986.</li>
</ul>
<h3>The feeling takes so long to grow</h3>
<p>After the contract with the megacorporation ended, the job market hit a short-term slump, at least locally. I had only one real suitor for a new position. It was a start-up out of Silicon Valley called eStamp. We had a slow courtship. I heard from them about every two weeks. The first call was from a recruiter, Amanda. Amanda was enthusiastic. She made the job sound fantastic and my chances sound great. The company she represented specialized in online stamp / mailing label sales. They needed a lead technical writer with strong web skills. Amanda liked my resume and my web site, so she decided that I was the perfect fit. The job paid a lot of money, $87,000 a year plus 1000 shares of stock per year for four years. I understood that the Bay Area housing market was pricy, but this seemed like enough money for me to live comfortably on and I liked the idea of moving to the nerve center of the geek universe. I also liked the idea of having a full-time job rather than a contract.</p>
<p>About two weeks passed before I had my first phone interview and another two weeks after that the company called for a follow-up interview. Both interviews went well, so they decided to fly me out to meet the crew for one final round of interviews. The trip took about two weeks to set up, of course. When I got there, everyone seemed enthusiastic and I came away feeling good. After the xenophobic atmosphere of the megacorporation, this little startup seemed downright friendly.</p>
<h3>I&#8217;m gonna take you by surprise</h3>
<p>Once I got home, however, another two weeks passed before I heard from them. Eventually, Amanda called to let me know that they wanted to hire me, but they were dropping their offer to $77,000. They wanted me to prove myself before they made me lead technical writer. It was a bit of a slap in the face. I had never had anyone cut their offer before.</p>
<p>If there had been any other opportunities brewing, I might have turned their offer down, but I needed work. I didn&#8217;t have any money left in my account. I told them that if they were going to drop my pay, then I needed a relocation allowance get me out there. At first they didn&#8217;t want to give it to me. They didn&#8217;t like the idea of laying out any money in advance. The company eventually agreed to give me $2000, but they wanted to put restrictions on it. The main sticking point was that they wanted the money back if I didn&#8217;t last at least six months. I was perfectly willing to give the money back if I quit, but I would not agree to repay them if they fired me or if I was laid off. Amanda was unsympathetic. She accused me of plotting to use eStamp to get to California where I could get a better-paying job. I explained to her that I was happy to repay them if I quit, but not if they decided to get rid of me. They were two separate issues. She told me she didn&#8217;t see the difference, but she would take my demand to them anyway. It was frustrating, and the days kept passing.</p>
<h3>Tomorrow may be too late</h3>
<p>I was about to cave in. I needed the job. I began to pack my stuff and I even signed the contract, but I left it on my desk rather than fax it to them. Amanda was supposed to give me eStamp&#8217;s final word on my request by the end of the day. I had decided that, no matter what their final offer was, I was going to take it and give the job my best shot.</p>
<p>At about two o&#8217;clock that afternoon, I got a phone call from a different recruiter &#8211; a local recruiter. This recruiter said she represented a major computer company that needed a new writer by Monday. I told her that was great, but if they wanted me, I needed an answer within three hours because I had another offer I was planning to take. Within ten minutes I was on the phone with the computer company&#8217;s technical communications manager and one of their writers. Within an hour my fax machine was spitting out a contract for a brand new job. Instead of heading blindly to Silicon Valley, I would be driving twenty minutes to a research park on the southeast side of Tucson. It was a contract job, and it paid less money, but I wouldn&#8217;t have to move.</p>
<h3>I don&#8217;t wanna lose you</h3>
<p>Amanda called at about four o&#8217;clock that afternoon. She was abrupt and irritated. She had decided to take a hard line with me. &#8220;They aren&#8217;t going to give in on this, so I need your answer now, yes or no.&#8221;</p>
<p>I took a breath. &#8220;I guess this isn&#8217;t going to work out then. Thank you for trying.&#8221;</p>
<p>&#8220;WHAT?&#8221;</p>
<p>To say that Amanda was upset would be a gross understatement. Amanda screamed. Amanda pouted. Amanda argued. It got even worse when she realized I was taking a position that paid less than their offer. I explained to her that this job didn&#8217;t require me to move. I could keep paying my dirt-cheap Tucson rent, so financially I would be better off. At some point Amanda started to cry. She accused me of leading her on. She called me a liar. She begged me to change my mind.</p>
<p>I stayed calm. I reminded her that eStamp had dragged their feet for almost two months. They had even dropped their offer. Once Amanda realized I wasn&#8217;t going to change my mind, she demanded that I call the manager at eStamp myself to tell her I wasn&#8217;t taking the job. This is not the sort of thing recruiters make applicants do, ever, but I agreed to do it just to get her off the phone.</p>
<h3>There&#8217;s something I just have to say</h3>
<p>I called the manager and let her know I was taking another job. The manager took it in stride. &#8220;This is the Silicon Valley,&#8221; the manager said, &#8220;it happens all the time. I don&#8217;t know why she was so upset.&#8221; The manager wished me luck in my new position and that was that. It was a strange day. I was thrilled to have a new job (and a local one at that) but I was also emotionally drained. I had never had a recruiter go through a meltdown before.</p>
<p>I was once again a gainfully employed technical writer. I had gone from a megacorporation to an even larger company. It was a company that had once been fabled for both its size <em>and</em> its culture. Even after ten years of layoffs, it was still one of the largest companies in the world. They were the stuff of legends. The glory days had since passed, but I was still going to be working for The Big Mothership. We&#8217;ll call it TBM. Now, the adventure was truly about to begin&#8230;</p>
<h3>Further Reading</h3>
<p><a href="http://www.boston-technical-recruiter.com/">A Boston Technical Recruiters Blog: </a>Even recruiters blog. There is some good advice here.</p>
<p><a href="http://www.asktheheadhunter.com/newsletter/OE20050823.htm">Deceptive Recruiting: HR&#8217;s Last Stand?</a> A discussion of recruiter ethics</p>
<h3>Questions</h3>
<p>What experiences have you had with recruiters?</p>
<p>What is the longest period you&#8217;ve ever had to wait between an interview and a job offer?</p>
<p>Have you ever had to personally turn down an employer?</p>
]]></content:encoded>
			<wfw:commentRss>http://www.poewar.com/a-career-in-technical-writing-amanda/feed/</wfw:commentRss>
		<slash:comments>10</slash:comments>
		</item>
		<item>
		<title>A Career in Technical Writing: Bright Lights, Big City</title>
		<link>http://www.poewar.com/a-career-in-technical-writing-bright-lights-big-city/</link>
		<comments>http://www.poewar.com/a-career-in-technical-writing-bright-lights-big-city/#comments</comments>
		<pubDate>Tue, 19 Aug 2008 02:00:26 +0000</pubDate>
		<dc:creator>John Hewitt</dc:creator>
				<category><![CDATA[Writing]]></category>
		<category><![CDATA[Big City]]></category>
		<category><![CDATA[Bright Lights]]></category>
		<category><![CDATA[Goodbye Stranger]]></category>
		<category><![CDATA[Technical Writing]]></category>

		<guid isPermaLink="false">http://www.poewar.com/?p=4347</guid>
		<description><![CDATA[Bullet Points Megacorporation is a term popularized by the cyberpunk novels of William Gibson. It denotes a multi-national corporation that has become so large that in many cases it is its own customer or even its own government. Megacorporations often come complete with their own military. These companies are considered to be fictional, but the [...]]]></description>
			<content:encoded><![CDATA[<p></p><h3>Bullet Points</h3>
<ul type="square">
<li><em>Megacorporation</em> is a term      popularized by the cyberpunk novels of William Gibson. It denotes a multi-national      corporation that has become so large that in many cases it is its own      customer or even its own government. Megacorporations often come complete      with their own military. These companies are considered to be fictional,      but the company I worked at had a U.S. Army base in its parking lot, so I      will let you be the judge.</li>
<li><em>Cubicle farm</em> is a term popularized      by Scott Adams of Dilbert fame. It describes an enormous room partitioned      off by low fabric walls that separate workers (but not sound). These cubicles      are approximately the same size and dimensions as the stalls that farms      use to house large animals. Another farm-related term for a cubicle is <em>veal-fattening pen</em> which was      popularized by Douglas Adams in the book <em>Generation X</em>.</li>
<li>A <em>disaster recovery plan</em> is a plan      for resuming key business functions (such as payroll and accounting) after      a catastrophic disruption in operations. Such a plan presumes that no      specific team member can be reached or contribute to the recovery, so all      processes must be independently executable.</li>
<li>An <em>extended stay hotel</em> caters to      business travelers who are in need of short to long-term housing. The      rooms tend to come with kitchens, free local phone service, weekly or      twice-weekly maid service, and on-site laundry facilities. The better hotels      have full cable television, concierge service, a pool and free continental      breakfast. I wasn&#8217;t at one of the better ones.</li>
<li>Phoenix, Arizona      regularly reaches <a href="http://ag.arizona.edu/maricopa/garden/html/weather/records.htm">temperatures above 110 degrees</a> in the summer.</li>
</ul>
<h3>Welcome to the Machine</h3>
<p><img class="alignright" style="float: right;" src="http://www.poewar.com/images/cubefarm.jpg" alt="A nice long row of cubes" />The branch of the megacorporation that I worked at was housed in a low-slung building that stretched on for at least a quarter-mile. My cubicle was in a warehouse-sized room that seemed to never end. At least 400 of us worked in this vast cubicle farm. My stall was located across the aisle from a flock of customer support personnel who serviced the Asian branches of the company. At any time during the day, I could hear a cacophony of languages that I didn&#8217;t understand a word of.</p>
<p>Their customer service work had nothing to do with my job, and not a single person in my row greeted me when I arrived or said anything beyond hello at any point during my stay. The only time I ever heard from any of them was when one of their herd sent an e-mail asking me to stop snapping my gum. I was chewing ginseng gum at the time in an effort to curb hunger pains as part of my most recent ridiculous diet. Apparently none of them were willing to ask me to stop directly. That would have required speaking to me. I was greatly amused to discover that my noise distracted them as much as their noise distracted me. I didn&#8217;t stop chewing the gum but I did try to back off on the snapping &#8211; a little.</p>
<h3>Fly Casual</h3>
<p>It turned out that writing service level agreements wasn&#8217;t as boring as I thought it was. It was geometrically more boring than I thought it was. I wasn&#8217;t even writing the materials. A friendly but bland middle manager wrote them up. All I had to do was read through the documents and fix the grammar, usage and formatting. I then sent the documents back to the friendly but bland middle manager and if he had any questions, he emailed them back to me. We rarely saw each other.</p>
<p>The work itself would have made for a dreadfully dull job, but the real problem was that he only produced something for me to edit about every three weeks. The remaining days were spent trying to look busy without using the Internet. If I didn&#8217;t look busy or if people saw me use the Internet, people complained. They didn&#8217;t complain to me. They didn&#8217;t talk to me at all. They complained to my friendly but bland middle-manager. This would result in an email from him. The friendly but bland middle manager sympathized with my lack of work, and he never seemed angry, but he made it clear that I could only use the Internet &#8220;during lunch&#8221;. To cope with my boredom, I brought in books on web development and FrameMaker. I also read whatever SAP guides they had lying around. It helped me to look busy, and I did learn a few things, but the days just dragged by.</p>
<h3>Summer in the City</h3>
<p>In addition to being bored at work, I was also bored when I got off work. I still considered Tucson to be my home, but I needed a place to stay in Phoenix. I rented a room by the week at an extended stay hotel. The room was decent, if ugly. It had a framed picture on the wall that I was sure contained a carpet remnant. It had a kitchen, but I never bothered to cook. I mainly lived off of Subway sandwiches (it worked for Jared) and Gatorade along with a refrigerator shelf full of the Kirkland brand diet drink. I had begun the job in the middle of July and the temperature rarely dipped under 100 degrees even in the middle of the night, so I never felt like going anywhere. For the most part I came home and watched baseball on the television or went for a swim. I scribbled some poetry in my journal then went to bed.</p>
<p>By late September I gave up on living in Phoenix and started driving up from Tucson every day. I did this mainly because it killed time and I could at least see my friends and family for an hour or two. I began listening to books on tape as I drove: <em>A Brief History of Time</em>, <em>The Razor&#8217;s Edge</em>, <em>The Lord of the Rings</em> trilogy (plus <em>The Hobbit</em>), the <em>Interview with a Vampire</em> series. Books on tape kept me going. All the driving was exhausting though. By late October the temperature had cooled somewhat, and I spent many of my lunch hours over the fall and winter months sleeping in my car. The office building was under the approach to <a href="http://en.wikipedia.org/wiki/Phoenix_Sky_Harbor_International_Airport">Sky Harbor Airport</a>. I watched the planes cruise in above me, one every thirty seconds, until I fell asleep. It was just like counting sheep.</p>
<h3>Flirtin&#8217; With Disaster</h3>
<p>Because I had nothing to do, and therefore no good reason to say no, the bland but friendly middle manager started sending me to meetings to take notes for him. I considered this to be secretarial work, and told him so, but it was still more pleasant than sitting in my cubicle trying to look busy. Most of these meetings were the standard megacorporation time-wasters. A roomful of people would gather to argue over timelines, statuses and budgets.</p>
<p>One group managed to capture my interest &#8212; the Disaster Recovery Team (DRT). The DRT (pronounced dirt) met every week to work on a plan for what to do if the central SAP site was destroyed and everyone was either dead or missing. This was a megacorporation, and it had a worldwide organization to run whether we were at the bottom of a smoking crater or not. I volunteered to write the disaster recovery plan.  They had set up collocations for the servers in Illinois and an archive storage facility in upstate New York. We put together a plan to reassemble this information if a disaster struck. We all agreed, quite rightly, that the priority would be the payroll department. The processes I documented were dry, but the meetings were fun because we got to spend a lot of time thinking of ways in which the site could be destroyed: earthquakes, fires, riots, chemical attacks, nuclear attacks, even disgruntled workers. We decided that a gun-toting employee did not rise to the level of disaster and was therefore outside of our scope. All of this speculation helped me to pass the days.</p>
<h3>Goodbye Stranger</h3>
<p>Beyond those moments, the job never did get interesting. After about eight months the friendly but bland middle manager called me in to let me know they were terminating my contract early. They didn&#8217;t have anything for me to do. He was nice enough to give me a month&#8217;s notice so I didn&#8217;t make waves about the &#8220;year contract&#8221; I had agreed to. Arizona is a right-to-work state, so I really didn&#8217;t have any recourse anyway. They could have let me go at any time.</p>
<p>I sent my resume out to the usual suspects, but the month passed without a nibble. To tell the truth, I wasn&#8217;t that disappointed. The daily drive and the boredom had left me exhausted and burnt out. I needed a break. The week after the job ended, my health caught up to me. I came down with a severe case of the flu and I barely got out of bed for almost a month.  I laid in bed and read, <a href="http://en.wikipedia.org/wiki/The_Girl_Who_Loved_Tom_Gordon">The Girl Who Loved Tom Gordon</a>, about a dozen times. Getting lost in the woods of northern Maine seemed oddly similar to having a never-ending bout with the flu.  It was quite a while before I felt like myself again, and by then I was in desperate need of another job. It was right about then that Silicon Valley called and asked me out on a date. Would it be a <a href="http://en.wikipedia.org/wiki/Love_Connection">Love Connection</a>?</p>
<h3>Further Reading</h3>
<ul>
<li><a href="http://www.scn.org/~jonny/genx.html">Douglas Coupland&#8217;s Generation X Neo-logisms</a>: Coupland provided many terms for corporate culture and job dissatisfaction including Anti-Sabbatical, Consensus Terrorism, McJob, Mid-Twenties Breakdown, Rebellion Postponement, and Sick Building Migration.</li>
<li><a href="http://www.drp.msu.edu/Documentation/StepbyStepGuide.htm">Step by Step Guide for Disaster Recovery Planning</a>: A good introduction to planning and writing a disaster recovery plan.</li>
<li><a href="http://techupdate.zdnet.com/techupdate/stories/main/0,14179,2806173,00.html">Service Level Agreements</a>: An overview of Service Level Agreements from the folks at ZDnet.</li>
</ul>
<h3>Questions</h3>
<ul>
<li>What experiences have you had with large corporations?</li>
<li>Have you ever been housed in a cubicle farm?</li>
<li>What is your ideal (realistic) corporate environment? Do you consider one to be possible?</li>
<li>Would it be a good idea to create a personal disaster recovery plan?</li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://www.poewar.com/a-career-in-technical-writing-bright-lights-big-city/feed/</wfw:commentRss>
		<slash:comments>2</slash:comments>
		</item>
		<item>
		<title>A Career in Technical Writing: By the time I get to Phoenix</title>
		<link>http://www.poewar.com/a-career-in-technical-writing-by-the-time-i-get-to-phoenix/</link>
		<comments>http://www.poewar.com/a-career-in-technical-writing-by-the-time-i-get-to-phoenix/#comments</comments>
		<pubDate>Sun, 17 Aug 2008 21:34:49 +0000</pubDate>
		<dc:creator>John Hewitt</dc:creator>
				<category><![CDATA[Writing]]></category>
		<category><![CDATA[Bullet Points]]></category>
		<category><![CDATA[Microsoft Word]]></category>
		<category><![CDATA[Technical Writing]]></category>
		<category><![CDATA[writer]]></category>

		<guid isPermaLink="false">http://www.poewar.com/?p=4344</guid>
		<description><![CDATA[Bullet Points The more relaxed you are, the better a job interview tends to go Subject knowledge is great, but tools skills help you land jobs A service level agreement (SLA) is a document that describes the performance criteria a provider promises to meet while delivering a service. The Next Interview I drove to Phoenix [...]]]></description>
			<content:encoded><![CDATA[<p></p><p><img class="alignright" style="margin: 5px; float: right;" src="http://poewar.com/images/panel.jpg" alt="Panel Interview" /><br />
<h3>Bullet Points</h3>
<ul type="square">
<li>The more relaxed you are, the better a job      interview tends to go</li>
<li>Subject knowledge is great, but tools skills      help you land jobs</li>
<li>A service level agreement (SLA)      is a document that describes the performance criteria a provider promises      to meet while delivering a service.</li>
</ul>
<h3>The Next Interview</h3>
<p>I drove to Phoenix to interview for a contract at a company that specialized in providing computer services and training. This company was a major player in the services field, but the place was decidedly less fancy than the one that had flown me into Dallas. The corporate location doubled as a call center. Like most call centers, the walls were covered with motivational sayings and banners pushing sales level contests and company pride. I couldn&#8217;t help but think of my experiences with the Help Desk manager at PHPS who wanted me to be a high-energy technical writer with a big smile on my face. The manager at this company, however, was decidedly low-energy.  He was overweight and unkempt &#8212; exactly the sort of geek I was comfortable working with.</p>
<p>We went over my experience and I showed him my newly improved portfolio. He seemed happy with it. He asked me the standard questions about past experience and work styles. He seemed to like my answers and I felt as if I was a good fit for what they were looking for. At the end of the interview he asked how soon I could be available if they decided they needed me. &#8220;Next week,&#8221; I told him. He nodded and shook my hand. I wasn&#8217;t sure if I had the job, but I felt better about this interview than I did about the interview in Dallas. When I got home, there was a message on my voice mail from the recruiter. She said that the manager had been very impressed. He had one more interview left to do, but I was the front-runner.</p>
<p>A few minutes later, I received a phone call from another Phoenix recruiter. This recruiter wanted to know if I was available for an interview <em>today</em>. I told her that I had just gotten back from Phoenix. I couldn&#8217;t handle driving back up there again that day, but I would be happy to come in the next day. She set up a meeting for eight the next morning.</p>
<h3>Mega-Corporation</h3>
<p>It was another contract position. This interview was with a mega-corporation that had more fingers in more pies than you can imagine. The first two companies I had interviewed with were in the Fortune 500, but this one was in the top ten. It not only had a substantial retail and manufacturing presence, it was also a major military contractor. The location I interviewed at came complete with its own little U.S. Army base.</p>
<p>I interviewed with two people, a manager and a writer. The writer had accepted another position, and they were looking for someone to replace her. Of my three interviews, this was the most relaxed. I was fairly sure that I had the other job and it showed. I sat back in my chair and listened to the two of them pitch the position. They told me that I would be writing supporting documentation for a major SAP (a finance and administration package for large companies) conversion project. Much of my work would be service level agreements and planning documents. It sounded like a dull job to me, but I didn&#8217;t say that in the interview. I stayed positive. My interviewers were mainly concerned with my Microsoft Word and FrameMaker skills. I told them I had once been a Microsoft Word trainer, and that everything in my portfolio was created in FrameMaker. That was what they wanted to hear. I walked out of the meeting feeling good.</p>
<h3>An Offer I Couldn&#8217;t Refuse</h3>
<p>That afternoon I got feedback on all three of my interviews. The interview in Dallas had been a bust, just as I suspected. They didn&#8217;t like my sample and they didn&#8217;t think I was a good fit for the company. The recruiter seemed slightly annoyed with me, and reminded me that my beach time would end with the next check. I was no longer their employee. Both Phoenix interviews, however, resulted in job offers. The computer services company offered me $25 per hour for a six-month contract that could extend &#8220;indefinitely&#8221;. The megacorporation offered me the same amount, but for a year contract. I told the recruiter and account manager for the megacorporation that I preferred the other contract. The duration was shorter, but the work sounded more interesting to me. I told them I didn&#8217;t want to spend the next year of life writing service level agreements and such.</p>
<p>The account manager asked if a higher offer might persuade me. I told her it might, but that I planned to accept the other offer as soon as I got off the phone. She asked me to wait a half hour. Forty-five minutes later, she called back. She upped the offer to $30 an hour plus a $240 a week tax-free mileage allowance for my travel expenses. I still wasn&#8217;t too thrilled with the work, but I needed the money (my debts were far from paid off) so I took the offer. Little did I know that I would soon be flirting with disaster&#8230;</p>
<h3>Further Reading</h3>
<p><a title="Permanent Link to Technical Writing â€“ Finding Jobs Through Agencies" rel="bookmark" href="http://www.freelancewritinggigs.com/2008/08/04/technical-writing-%e2%80%93-finding-jobs-through-agencies/">Technical Writing â€“ Finding Jobs Through Agencies by Ugur Akinci, Ph.D.</a>: Additional information on what to consider when using a consulting agency in your technical writing job search.</p>
<h3>Questions</h3>
<ul>
<li>If you had to choose between a moderate paying job that sounded interesting or a much higher paying job that sounded dull, which would you choose?</li>
<li>Would your answer change if you were deep in debt or completely out of debt?</li>
</ul>
<p><em><strong>Note</strong>: This post was originally a part of the last post in the series, </em><a href="http://www.poewar.com/a-career-in-technical-writing-planes-trainers-and-automobiles/">Planes, Trainers and Automobiles</a> <em>but was separated because it ran too long. The two posts are really companion pieces.</em></p>
]]></content:encoded>
			<wfw:commentRss>http://www.poewar.com/a-career-in-technical-writing-by-the-time-i-get-to-phoenix/feed/</wfw:commentRss>
		<slash:comments>8</slash:comments>
		</item>
		<item>
		<title>A Career in Technical Writing: Beach Time</title>
		<link>http://www.poewar.com/a-career-in-technical-writing-beach-time/</link>
		<comments>http://www.poewar.com/a-career-in-technical-writing-beach-time/#comments</comments>
		<pubDate>Mon, 04 Aug 2008 11:01:27 +0000</pubDate>
		<dc:creator>John Hewitt</dc:creator>
				<category><![CDATA[Writing]]></category>
		<category><![CDATA[Bullet Points]]></category>
		<category><![CDATA[Sim City]]></category>
		<category><![CDATA[TDI]]></category>
		<category><![CDATA[Technical Writing]]></category>

		<guid isPermaLink="false">http://www.poewar.com/?p=4321</guid>
		<description><![CDATA[Bullet Points Beach time and bench time refer to paid or unpaid time off between consulting contracts When you are a contractor, it is best to take initiative and find other options no matter how much you trust your recruiter Never trust a company to have your best interests in mind The Waiting Game I [...]]]></description>
			<content:encoded><![CDATA[<p></p><h3>Bullet Points</h3>
<ul>
<li>Beach time and bench time refer to paid or unpaid time off between consulting contracts</li>
<li>When you are a contractor, it is best to take initiative and find other options no matter how much you trust your recruiter</li>
<li>Never trust a company to have your best interests in mind</li>
</ul>
<h3>The Waiting Game</h3>
<p><img class="alignright" style="margin: 5px; float: right;" src="http://www.poewar.com/images/beach.gif" alt="Beach List" width="150" height="315" />I did not expect to be without a new position for as long as I was. Because I was still employed by my contract agency, I was still being paid, even though I wasn&#8217;t doing any work. Some companies call this beach time. Other companies call this bench time. I was under the impression that beach time would be a strong motivator for the company to find me another job, but several weeks passed without an interview. I called about once a week to check in with my company. Most of the time I got the answering machine because my account manager was never in. Other than that I didn&#8217;t hear from them. Either out of loyalty or laziness, I didn&#8217;t start looking for positions on my own. I worked on my novel, redesigned my web site and played a lot of pool. I think I played Sim City 2000 for about a week straight. I didn&#8217;t start to worry until the checks stopped coming.</p>
<h3>Fighting for my rights</h3>
<p>Apparently TDI decided that they didn&#8217;t have any work for me, so they stopped paying me. They didn&#8217;t send me a notice or call to tell me that they were giving up. They just stopped paying me. I was, as you might expect, upset. I tried to call the Phoenix Account Manager, but he was out of the office as usual. I then tried to contact the main office, but no one seemed interested in talking to me. At that point I wrote a letter. In the letter I accused them of fraud and wrongful termination and I told them that if I did not hear from them by the end of the week I would file a grievance with the state labor board. Because I lived in Arizona, a right-to-work state, there really was no state labor board for me to go to, but this was a California company so I assumed they didn&#8217;t know how things worked in Arizona.</p>
<p>I faxed the letter to their head office and waited. At this point I was prepared to hear the worst, or nothing at all. Within a half hour my phone rang. It was a company vice president, and he was just short of apologetic. He made it clear that they couldn&#8217;t keep me on forever, and I made it clear that their failure to send me on even a single interview didn&#8217;t represent much of a commitment on their part. By the end of the call he had agreed to pay me for the past three weeks and for one more month. He also promised to make a genuine effort to find me more work. They sent me my back pay by overnight mail.</p>
<h3>Getting back in the game</h3>
<p>I still hoped that TDI would find me another gig, but at this point I was no longer counting on it. I needed work. I was still up to my armpits in debt and I couldn&#8217;t afford even a few weeks without pay.  I posted my resume on Dice and Monster and mailed it to all of the Tucson and Phoenix technical employment agencies I could find. Three more weeks passed without much movement, but in the final week before my last paycheck, interest picked up. TDI, the company that still employed me, managed to land me a job interview in Dallas. Meanwhile, my resume had generated two more interviews, both in Phoenix. I was about to experience three very different interviews, and get two offers&#8230;</p>
<h3>Further reading</h3>
<ul>
<li><a href="http://employeeissues.com/">EmployeeIssues.com</a> is a great site for researching your rights and the ways to defend them</li>
<li> <a href="http://www.cvtips.com/blog/unemployed-time-on-your-hands.html">Time Management for the Unemployed</a>: When you need work, you need to pay attention to time management</li>
</ul>
<h3>Questions</h3>
<ul>
<li>Have you ever had a dispute with an employer about pay? How did you handle it?</li>
<li>Do you have any tips about the best use of employment downtime?</li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://www.poewar.com/a-career-in-technical-writing-beach-time/feed/</wfw:commentRss>
		<slash:comments>4</slash:comments>
		</item>
		<item>
		<title>A Career in Technical Writing: End of Part One</title>
		<link>http://www.poewar.com/a-career-in-technical-writing-end-of-part-one/</link>
		<comments>http://www.poewar.com/a-career-in-technical-writing-end-of-part-one/#comments</comments>
		<pubDate>Wed, 23 Jul 2008 13:45:37 +0000</pubDate>
		<dc:creator>John Hewitt</dc:creator>
				<category><![CDATA[Writing]]></category>
		<category><![CDATA[article]]></category>
		<category><![CDATA[Technical Writing]]></category>

		<guid isPermaLink="false">http://www.poewar.com/?p=4304</guid>
		<description><![CDATA[End games concludes the first part of my series on a career in technical writing. The journey so far has taken us from my beginning as an outsider looking for his first job in the career through to the end of my first contract assignment. This seems like a good point to ask, &#8220;How am [...]]]></description>
			<content:encoded><![CDATA[<p></p><p><a title="A Career in Technical Writing: End games" href="../articles/a-career-in-technical-writing-end-games/"><img class="alignright" style="margin: 5px; float: right;" src="http://poewar.com/images/qm.jpg" alt="Question Mark" width="152" height="198" />End games</a> concludes the first part of my series on a career in technical writing. The journey so far has taken us from my beginning as an outsider looking for his first job in the career through to the end of my first contract assignment. This seems like a good point to ask, &#8220;How am I doing?&#8221;</p>
<ul>
<li>Do you still like the structure (bullet points, article. further reading, questions)? Are they making the articles too long or do they add to the value? Would you rather just hear the tale?</li>
<li>Were you expecting something different? Some people may have expected a &#8220;how-to&#8221; approach. This is more of a tour of aÂ  writing career. I am hoping people find it helpful.</li>
<li>What do you want to read more of or see less of?</li>
</ul>
<p><strong>A Career in Technical Writing Series (so far)<br />
</strong></p>
<blockquote>
<ul>
<li><a title="A Career in Technical Writing: Life as a wannabee" href="../articles/a-career-in-technical-writing-life-as-a-wannabee/">A Career in Technical Writing: Life as a wannabee</a></li>
<li><a title="A Career in Technical Writing: Two dates to the prom" href="../articles/a-career-in-technical-writing-two-dates-to-the-prom/">A Career in Technical Writing: Two dates to the prom</a></li>
<li><a title="A Career in Technical Writing: The fax about outsourcing" href="../articles/technical-writing-fax-outsourcing/">A Career in Technical Writing: The fax about outsourcing</a></li>
<li><a title="A Career in Technical Writing: A strange new world" href="../articles/a-career-in-technical-writing-a-strange-new-world/">A Career in Technical Writing: A strange new world</a></li>
<li><a title="A Career in Technical Writing: Life as a newbie" href="../articles/a-career-in-technical-writing-life-as-a-newbie/">A Career in Technical Writing: Life as a newbie</a></li>
<li><a title="A Career in Technical Writing: Workaround" href="../articles/workaround/">A Career in Technical Writing: Workaround</a></li>
<li><a title="A Career in Technical Writing: Last Contractor Standing" href="../articles/a-career-in-technical-writing-last-contractor-standing/">A Career in Technical Writing: Last Contractor Standing</a></li>
<li><a title="A Career in Technical Writing: Reversals" href="../articles/a-career-in-technical-writing-reversals/">A Career in Technical Writing: Reversals</a></li>
<li><a title="A Career in Technical Writing: End games" href="../articles/a-career-in-technical-writing-end-games/">A Career in Technical Writing: End games</a></li>
</ul>
</blockquote>
]]></content:encoded>
			<wfw:commentRss>http://www.poewar.com/a-career-in-technical-writing-end-of-part-one/feed/</wfw:commentRss>
		<slash:comments>17</slash:comments>
		</item>
		<item>
		<title>A Career in Technical Writing: End games</title>
		<link>http://www.poewar.com/a-career-in-technical-writing-end-games/</link>
		<comments>http://www.poewar.com/a-career-in-technical-writing-end-games/#comments</comments>
		<pubDate>Tue, 22 Jul 2008 13:37:12 +0000</pubDate>
		<dc:creator>John Hewitt</dc:creator>
				<category><![CDATA[Writing]]></category>
		<category><![CDATA[Bullet Points]]></category>
		<category><![CDATA[Discussion Questions]]></category>
		<category><![CDATA[PHPS]]></category>
		<category><![CDATA[Technical Writing]]></category>

		<guid isPermaLink="false">http://www.poewar.com/?p=4302</guid>
		<description><![CDATA[Bullet Points Sometimes all your work can be erased by a business decision Companies will never pay technical writers as well as programmers Take pride in your work, even if it never quite comes out the way you want it to On your last day, shake everyone&#8217;s hand and smile The final push As my [...]]]></description>
			<content:encoded><![CDATA[<p></p><h3><img class="alignright" style="margin: 5px; float: right;" src="http://poewar.com/images/chess.jpg" alt="Chess Game" width="290" height="414" />Bullet Points</h3>
<ul>
<li>Sometimes all your work can be erased by a business decision</li>
<li>Companies will never pay technical writers as well as programmers</li>
<li>Take pride in your work, even if it never quite comes out the way you want it to</li>
<li>On your last day, shake everyone&#8217;s hand and smile</li>
</ul>
<h3>The final push</h3>
<p>As my year contract at PHPS edged towards its conclusion, I felt as if I was working at an entirely different company than the one I had started with. The contractors I had begun my job with were long gone. The manager I had started with, and the one that followed him, were gone as well. The company had worked its way through a merger just a few months after I arrived, had then attempted a second merger which fell through, and finally was bought wholesale by a much larger company. As my stay concluded, and I delivered my final manuals, I found out that the entire reporting system that I had spent the year documenting was to be replaced with the new company&#8217;s system. Within three months, nothing I worked on would be in use.</p>
<p>This didn&#8217;t stop me from making my pitch for a full-time job. I had successfully met all of my deliverables and I was perfectly capable of documenting whatever took its place. My final manager strung me along until the last week. He had me research the going pay rates to justify my salary request ($40,000 a year), give him my resume and write up some additional documentation of their payment processes. I did everything he asked, but I don&#8217;t think I ever really expected him to give me a job. He didn&#8217;t. He said that they couldn&#8217;t afford me.</p>
<p>I was angry. I was angry because I had made it clear over a month earlier that if they couldn&#8217;t afford me, I wanted to know quickly so I could look at other options. He had told me it wasn&#8217;t an issue as long as I could prove my salary request was well within industry standards, which I had done. I didn&#8217;t confront him though. I shook his hand and thanked him for trying. There were still a lot of people I liked at the company, and I didn&#8217;t want to burn my bridges.</p>
<h3>Lunching and number crunching</h3>
<p>It wasn&#8217;t until my going-away lunch with my friend Rick, one of the programmers, that I found out how doomed my salary request was. I told him that I had asked for $40,000. He shook his head. &#8220;I&#8217;m a programmer and I only make $35,000.&#8221; It was sad but true. The high-dollar contractors had been replaced by a guy happy to make $35,000 a year, at least $20,000 less than the least experienced contract programmer had made. As a parting gift, I told him that Lynn, the ex-lead programmer, was now making six-figures and working from home. Rick left PHPS within two months to become a well-paid contractor. I&#8217;d like to say the company learned a lesson, but by then they were looking to get rid of the SpeedWare programmers anyway.</p>
<p>My final day at PHPS was quiet and pleasant. I had completed all of my assignments, and spent most of the day saying goodbye to people and cleaning out my cubicle. I had hoped to stay, but in the end I was happy to be leaving. I had met my goals and I had learned a lot. I had proven to myself that I could make a living as a technical writer. Also, I was still employed by my contract agency, even though they had yet to find me another job. I was about to experience beach time&#8230;</p>
<h3>Further Reading</h3>
<p><a href="http://www.mahalo.com/How_to_Leave_a_Job_on_Good_Terms">How to Leave a Job on Good Terms by </a><a href="http://www.mahalo.com/How_to_Leave_a_Job_on_Good_Terms">by Jason W</a>: Tips for leaving the workplace with your relationships intact.</p>
<p><a href="http://www.lostechies.com/blogs/chad_myers/archive/2008/06/08/some-consulting-wisdom-i-picked-up.aspx">Rules of Consulting by Chad Myers</a>: Don&#8217;t expect the customer to be rational. If the customer didn&#8217;t have problems, they wouldn&#8217;t have needed to hire you.</p>
<h3>Discussion Questions</h3>
<ul>
<li>What is the most involved project you&#8217;ve ever completed?</li>
<li>Have you ever been shocked to find out how little a co-worker makes?</li>
<li>What was your most interesting final day at a company?</li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://www.poewar.com/a-career-in-technical-writing-end-games/feed/</wfw:commentRss>
		<slash:comments>12</slash:comments>
		</item>
		<item>
		<title>A Career in Technical Writing: Reversals</title>
		<link>http://www.poewar.com/a-career-in-technical-writing-reversals/</link>
		<comments>http://www.poewar.com/a-career-in-technical-writing-reversals/#comments</comments>
		<pubDate>Mon, 21 Jul 2008 15:12:35 +0000</pubDate>
		<dc:creator>John Hewitt</dc:creator>
				<category><![CDATA[Writing]]></category>
		<category><![CDATA[Allen Wysocki]]></category>
		<category><![CDATA[Bullet Points]]></category>
		<category><![CDATA[PHPS]]></category>
		<category><![CDATA[Technical Writing]]></category>

		<guid isPermaLink="false">http://www.poewar.com/?p=4301</guid>
		<description><![CDATA[Bullet Points Adjusting to corporate life can be difficult, especially if you have a tendency to curse A cubicle is a terrible place to receive a lecture The best way through a work crisis is to do your job well The one constant when it comes to managers is change A visit from Ted It [...]]]></description>
			<content:encoded><![CDATA[<p></p><h3>Bullet Points</h3>
<ul>
<li> Adjusting to corporate life can be difficult, especially if you have a tendency to curse</li>
<li> A cubicle is a terrible place to receive a lecture</li>
<li> The best way through a work crisis is to do your job well</li>
<li> The one constant when it comes to managers is change</li>
</ul>
<h3>A visit from Ted</h3>
<p><img class="alignright" style="margin: 8px; float: right;" src="http://poewar.com/images/arms.jpg" alt="Boss Arms" width="283" height="424" />It was at about the tenth month when my mouth got me in trouble. I had said the wrong word about the wrong person at the wrong meeting. This brought a visit from my supervisor Ted, a falsely optimistic alpha-male who had threatened to fire me the first time we ever met. I had no idea trouble was coming when he stopped by my cube, but I naturally dreaded seeing him anyway. No one had said anything to me at the meeting. It had been a quick comment in a larger conversation. Days had passed between the meeting and my manager showing up. He worked out of Phoenix and only came to in Tucson about once a week.</p>
<p>Ted chose to dress me down about the issue in my cube. He wasn&#8217;t shouting, but he wasn&#8217;t whispering either. More than once the word anal lit up the air around my cube as the people who worked next to me got to hear him tell me that I had been inappropriate and disrespectful. I apologized to him and tried to explain that I hadn&#8217;t meant any harm. All through the conversation I had the sinking feeling that I was going to be fired, but the words never came. After about a half hour he ran out of steam and left my cube with a vague threat about my not having a future with the company.</p>
<p>I felt terrible. There was always company gossip before a meeting, and I had fallen into it. I had gotten comfortable with the people around me and I hadn&#8217;t watched my language or my attitude. I had no one to blame but myself. I probably should have apologized to my co-worker and I regret not doing so, but I just wanted the whole thing to go away so I jumped back into my work.</p>
<h3>Working my way back</h3>
<p>I stopped going to the meetings and I holed up in my cube. When I&#8217;d started with the company, there had been 160 report programs to document, but as the year had passed the number grew steadily until it had reached around 220. With two months to go, I still had about 80 programs left to document. The good news was that I had found my rhythm by that point. The programs all shared the same interface and many shared steps and variables. The last 80 were a lot of work, but far easier than the first 140 or so. I was documenting about three programs a day at that point, all with screenshots, descriptions and step-through instructions.</p>
<p>After the lecture from Ted, I gave up, for the most part, on a permanent position. I just wanted to get the last of the programs out and move on to a new gig. Just when I had written PHPS off though, Ted ceased to be a problem. One day I simply got an email from the IT manager telling me that Ted had left the company. It was a glowing letter about how much they would miss him and how important he had been to the company.</p>
<p>I couldn&#8217;t wipe the smile off of my face the whole day. Ted had finally found a way to put a bounce in my step. The question was, was it too late for me to wrangle a permanent job?</p>
<h3>Further reading</h3>
<p><a href="http://edis.ifas.ufl.edu/HR024"> Understanding Conflict in the Workplace by Julie Gatlin, Allen Wysocki, and Karl Kepne</a>: A discussion of the eight causes of conflict in the workplace.</p>
<p><a href="http://zenhabits.net/2007/08/get-off-your-butt-16-ways-to-get-motivated-when-youre-in-a-slump/">Get Off Your Butt: 16 Ways to Get Motivated When You&#8217;re in a Slump by Leo Babauta</a>: A great guide to finding your way back when your enthusiasm is lagging.<strong><br />
</strong></p>
<h3>Discussion questions</h3>
<ul>
<li> What is the worst mistake you ever made at a job?</li>
<li> How did you go about correcting that mistake? Could you?</li>
<li>What are some of the unwritten rules in your workplace?</li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://www.poewar.com/a-career-in-technical-writing-reversals/feed/</wfw:commentRss>
		<slash:comments>25</slash:comments>
		</item>
		<item>
		<title>A Career in Technical Writing: Last Contractor Standing</title>
		<link>http://www.poewar.com/a-career-in-technical-writing-last-contractor-standing/</link>
		<comments>http://www.poewar.com/a-career-in-technical-writing-last-contractor-standing/#comments</comments>
		<pubDate>Wed, 16 Jul 2008 19:52:43 +0000</pubDate>
		<dc:creator>John Hewitt</dc:creator>
				<category><![CDATA[Writing]]></category>
		<category><![CDATA[Bullet Points]]></category>
		<category><![CDATA[Discussion Questions]]></category>
		<category><![CDATA[PHPS]]></category>
		<category><![CDATA[Technical Writing]]></category>

		<guid isPermaLink="false">http://www.poewar.com/?p=4295</guid>
		<description><![CDATA[Bullet Points Many people turn contract positions into full-time opportunities Contractors are often treated much differently than employees Corporate environments continually change and evolve Mergers usually create radical changes within a company When the going gets tough, the people with options leave A good technical writer knows to choose words carefully The good times Despite [...]]]></description>
			<content:encoded><![CDATA[<p></p><h3>Bullet Points</h3>
<ul>
<li>Many people turn contract positions into full-time opportunities</li>
<li>Contractors are often treated much differently than employees</li>
<li>Corporate environments continually change and evolve</li>
<li>Mergers usually create radical changes within a company</li>
<li>When the going gets tough, the people with options leave</li>
<li>A good technical writer knows to choose words carefully</li>
</ul>
<h3>The good times</h3>
<p><a href="http://www.poewar.com/wp-content/uploads/2008/07/mergerhelp1.gif"><img class="alignright size-medium wp-image-4297" style="float: right; margin: 10px;" title="mergerhelp1" src="http://www.poewar.com/wp-content/uploads/2008/07/mergerhelp1-141x300.gif" alt="Merger Help" width="141" height="300" /></a>Despite the problems with organization and equipment, PHPS was actually a pretty pleasant place to work for most of my stay. The flat management structure didn&#8217;t provide much direction, but it also allowed me a certain degree of freedom to experiment and learn. I had quite a few friends at PHPS too. Most of the contractors came from the same agency and worked in the same area as I did, so we often went to lunch together. I had also made some friends among the regular employees, and some of us took Tai Chi classes together after work. I was putting out user manuals at a steady pace and the reaction was mostly positive. More than once, people at the company asked if I would be interested in coming on permanently.At one point it seemed almost certain that I would be hired after my year contract was up.</p>
<h3>Merged and managed</h3>
<p>Things began to change at about the eight month mark. PHPS had decided to merge with another company in Phoenix. The Phoenix company was larger, and was going to be setting most of the new rules, even though they would be keeping the PHPS name because PHPS was more highly regarded. As the merger progressed, the first thing to go was the flat management structure.</p>
<p>The new version of the company divided out the development group and added new team lead and a new manager. The team lead (for both programmers and business analysts) was a really nice guy with some good ideas and solid leadership skills. He fit in well with the team and helped to solve day-to-day issues. The new manager wasn&#8217;t so great. It was clear (at least to us) that his loyalties were to the company first, the Phoenix team second, the Tucson team third and the contractors dead last. Rather than have team meetings as a whole group, he held separate meetings with the regular staff and the contractors. The meetings with the contractors were chilly. In the very first meeting, when the lead programmer (who was a contractor) brought up a couple technical issues, the manager stated flat-out that any contractor who didn&#8217;t like the situation should leave.</p>
<h3>Exodus</h3>
<p>The problem with telling this to the lead programmer was that he was by far the best programmer they had. You don&#8217;t make a contractor your lead programmer unless he is really, really good. There were six programmers at that point &#8212; three contract programmers and three regular employees. On a six man team Lynn, was easily responsible for half the output. He was that good and that fast. He was also in demand.</p>
<p>Lynn wasn&#8217;t happy. His problem (until then) hadn&#8217;t been with PHPS, it had been with the consulting agency that employed us. Much like PHPS, the agency was going through a merger and conditions were changing. We went from being paid every two weeks to getting paid twice a month. We still had to bill weekly though, which made for some odd-looking hours sheets that made the managers nervous. We also went from having the VP at the agency fly in once a month and treat us to dinner to reporting to an unseen guy out of Phoenix who rarely returned calls. Lynn didn&#8217;t need to put up with those problems. Twenty minutes after that first meeting Lynn was on the phone, and two weeks later he was working out of his home for $12,000 more a year. PHPS, finally realizing they were losing a valuable person, offered to match the money and bring him on permanently but by then it was too late. He wanted out. The other two contractors didn&#8217;t stick around long either. Within a month, I was the last contractor standing.</p>
<h3>A hitch in my get-along</h3>
<p>Once the other contractors had left, the company saw no reason to keep me with the development team, even though almost all of my work was with them. Instead, they moved me to the help desk team. I didn&#8217;t man the help desk, but I reported to their manager. My first meeting with the help desk manager (a one-on-one lunch) went about as well as the first meeting with the development manager. I discussed some of the obstacles I was facing (equipment problems, a lack of feedback/direction) and I was told that if I didn&#8217;t think I could do the job, I should leave. I backed off and stopped raising issues. Unlike Lynn, I didn&#8217;t have a dozen other companies trying to lure me away and I actually wanted to be a permanent employee. He told me if I wanted to stay I needed to put &#8220;a bounce in my step&#8221; and &#8220;fly with the eagles.&#8221;</p>
<p>I knew I was in trouble. At 300 pounds, I didn&#8217;t bounce and I didn&#8217;t fly. Things bounced or flew off me. I did what I could though. I removed the six-foot cardboard cutout of the Starship Voyager from my cube and began wearing slacks, long-sleeved shirts and ties to work on the days he came down from Phoenix (even though the company only required polo shirts and khakis). I walked faster. I faked a positive and outgoing personality as best I could. I adopted a name for this persona, &#8220;Dynamic John&#8221;. He was the guy with the enthusiastic can-do attitude. I could keep it up for about six hours, which was usually enough. This technique worked for a while because I only had to see the guy once a week. The rest of the week I could be my normal self and get work done.</p>
<h3>A poor choice of words</h3>
<p>Because I still worked with the development team, I still attended the development team meetings. The other contractors were gone, but the rest of the team remained intact and they had hired one new full-timer to replace the contractors they lost. As we were waiting for the meeting to start, someone mentioned that Shelly, one of the trainers, was being promoted training supervisor. I said that would be terrific because she was so organized, except I didn&#8217;t say &#8220;organized&#8221;. I said &#8220;anal&#8221;, as in &#8220;anal retentive&#8221;. It was a quick thoughtless statement in a longer conversation and nobody reacted badly at the time. I didn&#8217;t realize I had done something wrong until my new manager came by to see me the next day&#8230;</p>
<h3>Further reading</h3>
<ul>
<li><a href="http://www.dorsethouse.com/books/pw.html">Peopleware: Productive Projects and Teams by Tom DeMarco and Timothy Lister</a>: A book about right way to create high performing creative and technical teams.</li>
<li><a href="http://www.gsb.stanford.edu/news/research/lead_carroll_mergers.shtml">The Key to a Successful Merger of Cultures? Look at Employee Demographics by Alice LaPlante</a>: An argument in favor of getting rid of people who resist a merger.</li>
</ul>
<h3>Discussion Questions</h3>
<ul>
<li>What experiences have you had with corporate mergers?</li>
<li>What do you think makes a good manager?</li>
<li>Do you change your personality when you go to work?</li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://www.poewar.com/a-career-in-technical-writing-last-contractor-standing/feed/</wfw:commentRss>
		<slash:comments>3</slash:comments>
		</item>
		<item>
		<title>A Career in Technical Writing: Workaround</title>
		<link>http://www.poewar.com/workaround/</link>
		<comments>http://www.poewar.com/workaround/#comments</comments>
		<pubDate>Sun, 13 Jul 2008 00:51:30 +0000</pubDate>
		<dc:creator>John Hewitt</dc:creator>
				<category><![CDATA[Writing]]></category>
		<category><![CDATA[AMISYS]]></category>
		<category><![CDATA[Bullet Points]]></category>
		<category><![CDATA[Microsoft Word]]></category>
		<category><![CDATA[Technical Writing]]></category>

		<guid isPermaLink="false">http://www.poewar.com/?p=4290</guid>
		<description><![CDATA[Bullet Points A workaround is a procedure designed to overcome a shortcoming of a program or piece of equipment. Sometimes the tools dictate the format of your work Projects tend to go better if you have a plan (believe it or not) Take the time to talk to the people on your project Beating the [...]]]></description>
			<content:encoded><![CDATA[<p></p><h3>Bullet Points</h3>
<ul>
<li>A workaround is a procedure designed to overcome a shortcoming of a program or piece of equipment.</li>
<li> Sometimes the tools dictate the format of your work</li>
<li>Projects tend to go better if you have a plan (believe it or not)</li>
<li> Take the time to talk to the people on your project</li>
</ul>
<h3>Beating the system</h3>
<p><img class="alignright" style="margin: 8px; float: right;" src="http://www.poewar.com/images/workaround.gif" alt="Workaround process" width="191" height="333" />Workarounds are common in the world of technical writing. They are the clever little solutions that you come up with because the program won&#8217;t do what you need it to do (<em>hack </em>is another term for this). In many cases, a workaround is needed because the program has a flaw. It is supposed to work a certain way, but it doesn&#8217;t. In other cases a workaround is needed because you want to make a program do something it was never designed to do. Workarounds aren&#8217;t just for hardware and software, they are for any situation in which you need to circumvent the established system. Workarounds are useful, and sometimes necessary, but they are never as good as a system that does what you need properly, and they are rarely supported.</p>
<p>After the success of the programmer&#8217;s reference, I wanted to put out a user&#8217;s guide. Of course, many of the problems that plagued my first attempt still had not gone away. I had no one telling me exactly what they wanted, and I still wasn&#8217;t sure what each report did or who it did it for. What I did have was the ability to take screenshots (images of the computer screen) and walk people through the process of filling out the pages needed to run the reports. I also had the information about what the output of the reports would be. By working with the main program (The main program was AMISYS and the report programs were custom written using SpeedWare) I started tracking down the variables as they corresponded to the report requests. This gave me some idea of what a user would enter.</p>
<h3>Talking to people would have helped</h3>
<p>Had I been more inclined to seek out the requesters and interview them, I surely would have come up with better information, but I was an introvert (according to my Myers-Briggs personality test I am INFP). The idea of tracking down strange people for information gave me an uneasy feeling with roots going all the way back to my daily beat-downs from schoolyard bullies as a kid (which thankfully ended when I grew to 6-1, 200 pounds by my freshman year in high school). My early days had taught me not to view strangers as friends, so I generally didn&#8217;t like to meet new people.</p>
<p>No one ever came along to ask how the project was going. Very few people, it seemed, had any understanding of what I was doing. The only people who showed any interest in my at all were the contract programmers. They would at least look at what I had written and offer advice, but none of them had a real stake in the outcome of my project. They were dealing with their own issues. Issues that I would soon get caught up in.</p>
<h3>A simple plan</h3>
<p>In the end, I came up with a simple format for the help. I documented each report with the following information (or as much of it as I had):</p>
<ul>
<li>Name of the program</li>
<li> File name for the program</li>
<li> Short (one sentence) description of the program</li>
<li> Screen shot of the first screen</li>
<li> Long description of the program (about a paragraph)</li>
<li> Step-by-step process of filling out the fields</li>
<li> Additional screen shots as needed for the process</li>
<li> Description of the output</li>
</ul>
<p>I&#8217;ve learned a few things over the years, and I&#8217;m sure I could come up with a better plan today, but at that point I was just happy to have a plan at all. This was a system that could have worked in Microsoft Word, although it would have been ugly. Microsoft Word does funny things when you add graphics. It tends to lose or move them, and it slows down dramatically. I had been pushing the company buy me FrameMaker for months (by this point I had grown to believe it could fix any problem), but the new FrameMaker required Windows 95 or Windows NT. The company eventually made the upgrade, and gave me my software, but by then I had a whole new set of problems to deal with. The work environment was about to change dramatically as I faced twin mergers, a new platitude-spouting manager and a programmer who hated my guts. Plus, I was about to say the word <em>anal </em>in front of the wrong crowd.</p>
<h3>Further reading</h3>
<ul>
<li><a href="http://www.16types.com/Request.jsp?lView=ViewArticle&amp;Article=OID%3A260627&amp;Page=OID%3A260628"> The 16 Personality Types by Linda V. Berens and Dario Nardi</a>: A lot of people have made a lot of money telling people who they are.</li>
<li><a class="super-permalink" title="Click here to read Make Your Own Pocket Duct Tape Dispenser" href="http://lifehacker.com/5023489/make-your-own-pocket-duct-tape-dispenser">Make Your Own Pocket Duct Tape Dispenser by Brad Isaac</a>: An excellent example of a workaround.</li>
<li><a href="http://www.wikihow.com/Take-a-Screenshot-in-Microsoft-Windows">How to Take a Screenshot in Microsoft Windows by wikiHOW</a>: It&#8217;s actually pretty easy</li>
</ul>
<h3>Discussion questions</h3>
<ul>
<li>What parts of your personality get in the way of your success?</li>
<li>What are your tips for planning a project?</li>
<li>Do you have a favorite workaround?</li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://www.poewar.com/workaround/feed/</wfw:commentRss>
		<slash:comments>6</slash:comments>
		</item>
		<item>
		<title>A Career in Technical Writing: Life as a newbie</title>
		<link>http://www.poewar.com/a-career-in-technical-writing-life-as-a-newbie/</link>
		<comments>http://www.poewar.com/a-career-in-technical-writing-life-as-a-newbie/#comments</comments>
		<pubDate>Thu, 10 Jul 2008 07:13:45 +0000</pubDate>
		<dc:creator>John Hewitt</dc:creator>
				<category><![CDATA[Writing]]></category>
		<category><![CDATA[editor]]></category>
		<category><![CDATA[Lot Done]]></category>
		<category><![CDATA[page]]></category>
		<category><![CDATA[Technical Writing]]></category>

		<guid isPermaLink="false">http://www.poewar.com/?p=4289</guid>
		<description><![CDATA[Bullet points Struggling to make the wrong tool work for a job can add months to a project FrameMaker is good for long technical documents PageMaker is good for sending a newsletter to your Aunt Fanny Sometimes the most important thing a technical writer can do is gather information When expectations are sufficiently low, it&#8217;s [...]]]></description>
			<content:encoded><![CDATA[<p></p><h3>Bullet points</h3>
<ul type="disc">
<li>Struggling      to make the wrong tool work for a job can add months to a project</li>
<li>FrameMaker      is good for long technical documents</li>
<li>PageMaker      is good for sending a newsletter to your Aunt Fanny</li>
<li>Sometimes      the most important thing a technical writer can do is gather information</li>
<li>When      expectations are sufficiently low, it&#8217;s easy to be a star</li>
</ul>
<h3>Meet your Maker</h3>
<p><img class="alignright" style="margin: 5px; float: right;" src="http://www.poewar.com/images/order.gif" alt="Audience" width="191" height="584" />I wish I could say I got off to a running start and quickly proved my value at my new job, but this is about my real career, not my resume. Life at PHPS did not begin with a bang. No one really knew what they wanted me to do, and my equipment wasn&#8217;t exactly state-of-the-art. I was hoping for FrameMaker, but I got PageMaker instead. The two products sound similar, but there is the world of difference between them. PageMaker wasn&#8217;t designed for long documents or technical material; it was designed for creating newsletters and flyers. I knew the product pretty well from my days working as an editor for a small newspaper, and I knew it wasn&#8217;t going to do anything I needed it to do. That didn&#8217;t stop me from trying. I designed a few pages of how-to materials, but the process was slow and tedious. Before I knew it, three months had passed and I really hadn&#8217;t produced much of anything. It was at that point that I decided to change course.</p>
<h3>That report has a lot of fans</h3>
<p>I had spent a lot of those first three months reading code and looking at output. Both the code and the output came on long bands of fanfold paper. You don&#8217;t see it as much anymore, but back then most reports were printed on page after page of green and white paper held together (and in order) by perforated edges. For some reports the code ran only half a dozen pages or so, but others ran much longer. As for output, that could go on for hundreds of pages, but I rarely needed to see much beyond the first and the last page. Those were the ones with the column headers and the totals.</p>
<h3>Sometimes your audience is just a cube away</h3>
<p>After three months of banging my head against a monitor trying to develop something for the end users, I gave up on that and decided to create a reference manual for the programmers. I wasn&#8217;t sure if it would be useful, but there was no one to tell me not to do it, so I just switched gears and started putting something together.</p>
<p>The reference manual was far from pretty. I created it using Microsoft Word, which could handle text just fine, even if it fell short on the artistic end. I went through the code for each program and documented the one thing I was sure the programmers would care about &#8212; the variables. Every program had a list of variable names somewhere in it, which it used to call up information from the database. In addition, the program code listed the header information and the column names for the output, so I documented those items too. I also had (from the interface) a list of what programs were used by which departments, so I recorded that. If I had any other information, such as someone&#8217;s description of the report, I plugged that in too. All of these items together started to look useful, so I showed it to the programmers.</p>
<h3>Believe it or not, I&#8217;m on top of the world</h3>
<p>The programmers were ecstatic. They loved it. Without knowing it, I had created exactly what they were looking for. They could now look over the reference and figure out if an old program could be turned into a new one because it shared enough key information. This would really speed up the programming process, they told me. I was a hit, but I felt a little guilty. Creating this really wasn&#8217;t that hard and I didn&#8217;t do any real writing. All I did was gather information. If I had known that this was what they needed, I could have given it to them three months earlier. I didn&#8217;t say this, of course. I just went back to my cube and tried to figure out what to do for the end users&#8230;</p>
<h3>Further reading</h3>
<p><a title="Permanent Link: Quick Reference Guides: The Poetry of Technical Writing" rel="bookmark" href="http://www.idratherbewriting.com/2008/07/06/quick-reference-guides-the-poetry-of-technical-writing/">Quick Reference Guides: The Poetry of Technical Writing by Tom Johnson</a>: An excellent guide to condensing a manual down to a two-sided piece of laminated paper.</p>
<p><a href="http://zenhabits.net/2008/06/how-to-get-a-lot-done-%e2%80%93-7-tips-to-achieve-more/">How to Get a Lot Done â€“ 7 Tips to Achieve More by Collis Ta&#8217;eed</a>: Planning, teaming, delegating&#8230; give it a try.</p>
<h3>Discussion questions</h3>
<ul type="disc">
<li>How do      you set goals for an unfamiliar project?</li>
<li>When a      strategy isn&#8217;t working, how do you know when to scrap it?</li>
<li>How do      you handle praise?</li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://www.poewar.com/a-career-in-technical-writing-life-as-a-newbie/feed/</wfw:commentRss>
		<slash:comments>10</slash:comments>
		</item>
	</channel>
</rss>

