<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" media="screen" href="/~d/styles/rss2full.xsl"?><?xml-stylesheet type="text/css" media="screen" href="http://feeds.feedburner.com/~d/styles/itemcontent.css"?><rss 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/" xmlns:feedburner="http://rssnamespace.org/feedburner/ext/1.0" version="2.0">

<channel>
	<title>Managing Writers</title>
	
	<link>http://managingwriters.com</link>
	<description>A Real World Guide to Managing Technical Documentation</description>
	<lastBuildDate>Fri, 13 Aug 2010 01:08:24 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.0.1</generator>
		<atom10:link xmlns:atom10="http://www.w3.org/2005/Atom" rel="self" type="application/rss+xml" href="http://feeds.feedburner.com/managingwriters" /><feedburner:info uri="managingwriters" /><atom10:link xmlns:atom10="http://www.w3.org/2005/Atom" rel="hub" href="http://pubsubhubbub.appspot.com/" /><item>
		<title>Does a manager need to be an SOB to survive?</title>
		<link>http://feedproxy.google.com/~r/managingwriters/~3/RESQIRv1QwM/</link>
		<comments>http://managingwriters.com/2010/08/12/does-a-manager-need-to-be-an-sob-to-survive/#comments</comments>
		<pubDate>Fri, 13 Aug 2010 01:08:24 +0000</pubDate>
		<dc:creator>Hamilton</dc:creator>
				<category><![CDATA[Commentary]]></category>
		<category><![CDATA[management]]></category>

		<guid isPermaLink="false">http://managingwriters.com/?p=338</guid>
		<description><![CDATA[In a recent article on BNET, The Real Reason for Bad Bosses, Jeffrey Pfeffer highlights a common, but little noted, paradox. To be a good manager, you need to be positive, supportive, and warm, but to be perceived as strong, &#8230; <a href="http://managingwriters.com/2010/08/12/does-a-manager-need-to-be-an-sob-to-survive/">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<p>
In a recent article on BNET, <a href="http://www.bnet.com/blog/business-psychology/the-real-reason-for-bad-bosses/202" title="Link to bnet article">The Real Reason for Bad Bosses</a>, Jeffrey Pfeffer highlights a common, but little noted, paradox. To be a good manager, you need to be positive, supportive, and warm, but to be perceived as strong, competent, and intelligent, you need to be critical and even nasty.
</p>
<h3>The Two-Faced Manager</h3>
<p>
While there is a lot of truth to Pfeffer&#8217;s argument, he misses an important point. There is no law that says you have to be one or the other. There are two audiences at play &#x2013; your team and the management team, including your peers and higher level managers &#x2013; and you are the interface between them. You can and should present a different face to each audience.
</p>
<p>
When it comes to surviving in the corporate world, being two-faced is not only okay, it is absolutely necessary. You need to be the most supportive, collaborative manager possible in interactions with your subordinates, and you need to be as strong as possible (without being overbearing) in interactions with your peers and higher level managers. Not only does this improve your image (and promotability) with the management team, it also helps to ensure that your team gets its fair share of the goodies.
</p>
<h3>Strong Does Not Mean Nasty</h3>
<p>
The other common mis-perception (which Pfeffer clearly does not share) is that you need to be visibly &#8220;tough&#8221; or even nasty to be strong. While this kind of behavior may make you look strong in the short run (and even longer in a dysfunctional organization), it is ultimately a sign of weakness, not strength, and will eventually be seen as such.
</p>
<p>
This does not mean that you can&#8217;t be firm with your team, and critical when called for, and it doesn&#8217;t mean you need to turn into an SOB when you interact with managers. And, it especially doesn&#8217;t mean that you need to lie to either audience. Instead, you need to understand that there are two audiences, with different needs and expectations. To be a good manager for your team, your organization, and your career, you need to give each audience what it expects and needs.</p>
<img src="http://feeds.feedburner.com/~r/managingwriters/~4/RESQIRv1QwM" height="1" width="1"/>]]></content:encoded>
			<wfw:commentRss>http://managingwriters.com/2010/08/12/does-a-manager-need-to-be-an-sob-to-survive/feed/</wfw:commentRss>
		<slash:comments>3</slash:comments>
		<feedburner:origLink>http://managingwriters.com/2010/08/12/does-a-manager-need-to-be-an-sob-to-survive/</feedburner:origLink></item>
		<item>
		<title>What STC can learn about certification from the FAA</title>
		<link>http://feedproxy.google.com/~r/managingwriters/~3/oQ-6UVt6PN0/</link>
		<comments>http://managingwriters.com/2010/07/20/stc-certification-and-the-faa/#comments</comments>
		<pubDate>Tue, 20 Jul 2010 21:24:45 +0000</pubDate>
		<dc:creator>Hamilton</dc:creator>
				<category><![CDATA[Commentary]]></category>
		<category><![CDATA[hiring]]></category>
		<category><![CDATA[STC]]></category>
		<category><![CDATA[technical writing]]></category>

		<guid isPermaLink="false">http://managingwriters.com/?p=302</guid>
		<description><![CDATA[As the STC develops its certification program for technical communicators, there are lessons that can be learned from the way the FAA certifies pilots. <a href="http://managingwriters.com/2010/07/20/stc-certification-and-the-faa/">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<p>
There has been a recent flare-up of discussion about certification for technical communicators and the forthcoming certification program from the Society for Technical Communication (STC).
</p>
<p>
Over the course of 100+ messages (I stopped counting at 100:-), the discussion has ranged from serious (does certification help or hurt job seekers) to off-the-wall (is the STC an evil organization bent on world (or at least tech comm world) domination).
</p>
<p>
However, to me, two critical questions have gotten short shrift: what can any certification program reliably say about the competence of an individual in a particular role, and how can participating in a certification program improve an individual&#8217;s skills as a technical communicator?
</p>
<p>
In short, can certification perform a useful function for both participants and hiring managers? I think it can, and I would suggest that STC look towards the FAA pilot certification program for insight into both the strengths and limitations of certification.
</p>
<p><span id="more-302"></span></p>
<p>
Pilot certification has the following critical components:
</p>
<ol>
<li><strong>Well-defined and limited scope:</strong> Your first pilot certificate is for small, single engine aircraft. To pilot more complex or larger aircraft, to work for hire, or to fly in the clouds, you need to complete additional training and testing.</li>
<li><strong>Appropriate subject matter:</strong> The FAA tests knowledge of regulations and practical flying skills. They recognize that they cannot reliably measure judgment, even though they recognize that good judgment is critical to flying safely.</li>
<li><strong>Clear standards for proficiency:</strong> The standards for passing both the knowledge exam and the practical test are clearly defined and documented. If you have ever taken a flight test, I have no doubt that you knew whether you passed or failed the test before being told. The standards and the acceptable variance are well understood and clear.</li>
<li><strong>Direct evaluation:</strong> While there is a multiple choice written test, the critical test is a check-ride, where you fly with an examiner who evaluates your performance against the standards. The examiner will also orally quiz you on your knowledge.</li>
<li><strong>Recurrent training and evaluation:</strong> To maintain your pilot certificate, you must pass a flight review at least every two years. In addition, various ratings have specific requirements for what it takes to remain current.</li>
<li><strong>A recognition that certification isn&#8217;t everything:</strong> Regardless of your certificates or experience, no one will rent you an airplane without a check-out with an instructor, and no airline will hire you as a pilot solely on the basis of your certificates. The certificate only says that at a particular point the holder was able to pass an exam and demonstrate a minimum set of skills. It says nothing definitive about whether someone is competent to perform in any particular capacity.</li>
</ol>
<p>
I&#8217;d argue that these characteristics are critical to any certification program. That said, there are aspects of the FAA program that do not apply to a certification program like the STC. These include the following:</p>
<ol>
<li><strong>The FAA is empowered by law to make and enforce regulations:</strong> The FAA is the sole authority for granting and taking away flying privileges. This is clearly not what anyone would want the STC to do (including the STC itself).</li>
<li><strong>A pilot certificate is a requirement to participate:</strong> Without a certificate, it is illegal to fly an airplane. Clearly that is neither true nor desirable for technical communication.</li>
<li><strong>Public safety:</strong> The primary purpose of the FAA pilot certification program is to help ensure public safety by imposing standards on the people who fly aircraft. While the safety of the people who use technical documentation is important, it certainly isn&#8217;t, and shouldn&#8217;t be, the primary concern of an STC certification program.</li>
</ol>
<p>
We can set these aspects of pilot certification aside, except to the extent that they color our perceptions of certification. In the case of STC certification, the biggest danger is that certification will be seen as a &#8220;requirement to participate.&#8221; More on that below.</p>
<p>
Let&#8217;s take a look at how the STC program stacks up against the FAA model. The <a href="http://notebook.stc.org/a-monumental-day-dawns-for-technical-communicators-certification/">announcement</a> for the STC certification program provides some important clues as to how the program is shaping up, but the program is still under development, so what follows is based only on what is public at this time.
</li>
<ol>
<li><strong>Well-defined and limited scope:</strong> This is, maybe understandably, still hard to judge. However, to be successful, there will need to be a clear definition of what each of the core competencies comprises. I suspect that over time, the STC will need to turn each core competency into a &#8220;track&#8221; that contains a selection of topics.</li>
<li><strong>Appropriate subject matter:</strong> I think this is one of the most dangerous areas for the STC. There are aspects of any field that are not amenable to certification. I don&#8217;t see how you can certify that someone possesses good judgment or the personal skills needed to work with a Subject Matter Expert (SME). It may also be difficult (or at least open to a fair amount of subjectivity) to certify the ability to select the right material for a particular deliverable and organize it correctly. Does that limit certification to purely mechanical skills like the ability to perform a set of tasks in FrameMaker? I hope not, but it will take experimentation and careful observation to draw the line between appropriate and inappropriate subject matter.</li>
<li><strong>Clear standards for proficiency:</strong> Here is where STC can judge how well it has defined the scope and appropriateness of its topics. If you can&#8217;t define what it means to be proficient at a topic, then either it&#8217;s not amenable to certification, or the topic is too broad.</li>
<li><strong>Direct evaluation:</strong> Evaluating a portfolio seems to me to be a useful and necessary, but not sufficient, step in this direction. I would add an oral exam and more direct interaction with the student as part of the evaluation.</li>
<li><strong>Recurrent training and evaluation:</strong> The three year duration of a certificate makes a lot of sense. It might be good to expand this into a recurrent training program that would allow people to maintain a certificate by taking and passing evaluations over that three-year period. It would also be useful to integrate the program with college and university technical communication programs.</li>
<li><strong>A recognition that certification isn&#8217;t everything:</strong> This is clearly another contentious issue, especially for technical communication. With pilot certification, an appropriate certificate is necessary, but not sufficient. With technical communication, it is neither necessary nor sufficient, but there is a valid concern that hiring managers will only look at candidates who are certified, or assume that possessing a certificate makes someone qualified. I&#8217;m not worried about the latter; any manager who persists in making that assumption won&#8217;t be a manager for long, but a manager who will not consider candidates without a certificate may never realize that there are competent people who don&#8217;t have one.</li>
</ol>
<p>
To go back to the questions I asked at the top:</p>
<ul>
<li><strong>What can a certification program reliably say about the competence of an individual in a particular role?</strong>
<p>About the best it can do is say that at time T, person A demonstrated the ability to convince the examiner that he or she met the requirements to earn the certificate. It says nothing about the ability of that person to perform any particular job, and it says nothing about whether that person has retained any knowledge or skills beyond the date of the test.</p>
</li>
<li><strong>Can participating in a certification program improve an individual’s skills as a technical communicator? </strong>
<p>
For a well-designed program, yes. Even for an experienced pilot, reviewing the knowledge and skills required of a new pilot are valuable. That&#8217;s why a flight review will always include skills, like stalls or short-field landings, that are required of a new pilot. It&#8217;s also why even the most experienced and skillful writers can benefit from re-reading Strunk and White or having their work edited by a skillful editor.
</p>
</li>
</ul>
<p>
I find it hard to sum up my thoughts on this. I think there is a place for certification, but only if that certification provides a way for people to acquire or reinforce useful skills, and if that certification helps hiring managers. That said, I have concerns:
</p>
<ol>
<li>Will the program reach too far and try to certify knowledge and skills that are not amenable to certification?</li>
<li>Will the program provide well-defined, appropriate levels of achievement?</li>
<li>Will the standards for earning a certificate be high enough to mean something?</li>
<li>Will the program integrate well with college and university technical communication degrees?</li>
<li>Will hiring managers and HR departments turn certification into a hard requirement?</li>
</ol>
<p>
The STC has direct control over the first four of these, and I hope they address them as part of the program.
</p>
<p>
The fifth issue highlights a tension inherent in the program. For certification to become widely accepted, it has to have value for hiring managers, and if it has value for hiring managers, they will want to see certification on résumés. That&#8217;s good for participants and good for the STC, but not good for qualified non-participants.
</p>
<p>
I don&#8217;t think you can avoid this in a successful program, but there are a few things that might help tamp down this effect:</p>
<ol>
<li>Make certification selective (i.e., rare) enough that it can&#8217;t become a common job requirement.</li>
<li>Make certification specific enough that it doesn&#8217;t ever appear to apply to the totality of a technical communicator&#8217;s job.</li>
<li>Make certification affordable, so money is not a barrier.</li>
<li>Make certification valuable enough that members see it as worth their effort to participate.</li>
</ol>
<p>
Beyond this, I&#8217;d say let the chips fall where they may and let the program prove itself.</p>
<img src="http://feeds.feedburner.com/~r/managingwriters/~4/oQ-6UVt6PN0" height="1" width="1"/>]]></content:encoded>
			<wfw:commentRss>http://managingwriters.com/2010/07/20/stc-certification-and-the-faa/feed/</wfw:commentRss>
		<slash:comments>8</slash:comments>
		<feedburner:origLink>http://managingwriters.com/2010/07/20/stc-certification-and-the-faa/</feedburner:origLink></item>
		<item>
		<title>Great idea, but…</title>
		<link>http://feedproxy.google.com/~r/managingwriters/~3/q79yqQDOwKw/</link>
		<comments>http://managingwriters.com/2010/07/01/great-idea-but/#comments</comments>
		<pubDate>Thu, 01 Jul 2010 20:28:18 +0000</pubDate>
		<dc:creator>Hamilton</dc:creator>
				<category><![CDATA[Commentary]]></category>
		<category><![CDATA[management]]></category>
		<category><![CDATA[managing change]]></category>

		<guid isPermaLink="false">http://managingwriters.com/?p=278</guid>
		<description><![CDATA[Users will change their habits when the pain of their current situation is greater than their perceived pain of adopting a possible solution. &#8211;Pip Coburn The Change Function Good ideas alter the power balance in relationships, that is why good &#8230; <a href="http://managingwriters.com/2010/07/01/great-idea-but/">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<p><em>Users will change their habits when the pain of their current situation is greater than their perceived pain of adopting a possible solution.</em></p>
<p>&#8211;Pip Coburn <a href="http://www.amazon.com/dp/B000NA6U2O" title="Link to The Change Function on Amazon"><em>The Change Function</em></a></p>
<p><em>Good ideas alter the power balance in relationships, that is why good ideas are always initially resisted.</em></p>
<p>&#8211;  Hugh MacLeod, <a href="http://gapingvoid.com/books/" title="Link to book page at gapingvoid.com"><em>Ignore Everybody</em></a></p>
<p>
Pip Coburn&#8217;s quote captures the most common reason good ideas fail. The pain of our current situation simply isn&#8217;t great enough for us to accept the pain it will take to change that situation. Yet, even when a rational analysis of a situation makes it clear that a change is essential,  great ideas are frequently not adopted. The key to understanding Coburn&#8217;s point, and to implementing great ideas, lies somewhat hidden in Coburn&#8217;s quote, specifically the word &#8220;perceived.&#8221;
</p>
<p>
Our perceptions of both our current pain, the pain of change, and the benefits of implementing a new idea are all distorted by human nature. We underestimate the pain of our current situation, overestimate the pain of changing that situation, and underestimate the future benefit. We also often completely miss the effect a good idea has on the balance of power in an organization.
</p>
<p><span id="more-278"></span></p>
<h3>We underestimate the pain of our current situation</h3>
<p>
It is human nature to become as comfortable as we can with our current situation, even when it is dysfunctional (that doesn&#8217;t stop us from complaining, but we do become accustomed to whatever our current situation is). Over time, we become used to our situation, adapt to it, and make it work for us as well as we can. The result is that we may perceive our current situation as being better than it really is.
</p>
<h3>We overestimate the pain of adopting a new idea</h3>
<p>
The perceived pain of nearly any change is elevated because it is largely unknown and because we either have direct experience with or have heard horror stories about previous changes. Given the success rate of implementing change of nearly any type, this is not an unreasonable reaction, but even so, we still tend to overestimate the pain of change.
</p>
<h3>We underestimate the benefits of implementing new ideas</h3>
<p>
Humans tend to ignore long-term benefits in favor of short-term comfort. That&#8217;s one reason most of us  exercise too little, eat too much, and take up habits like smoking. We know the consequences, but that doesn&#8217;t stop us. Dan Ariely&#8217;s new book, <a href="" title="Link to The Upside of Irrationality on Amazon.com"><em>The Upside of Irrationality: The Unexpected Benefits of Defying Logic at Work and at Home</em></a>, is worth checking out if you&#8217;re curious about what a scientist has to say about the question of why we act this way.
</p>
<p>
However, regardless of why we act this way, we do, and that has an impact on our perceptions about change. The further out the benefit, the stronger it will need to be for us to act.
</p>
<h3>We misunderstand the impact a new idea has on personal power</h3>
<p>
Finally, we come to the question of power. Accepting someone&#8217;s idea gives that person power and increases his or her standing relative to others in the organization. Any shift in power creates losers, and those losers will feel the urge to resist. If there is just one &#8220;parent&#8221; to an idea, then there are lots of &#8220;losers&#8221; who will perceive the cost of change as including a reduction in their power.
</p>
<p>
In practical terms, if you keep hearing about something as &#8220;Mary&#8217;s idea&#8221; or &#8220;Fred&#8217;s idea,&#8221; then you know there will be resistance based on power. If Mary&#8217;s idea is accepted, that increases Mary&#8217;s power, and if it&#8217;s rejected, it reduces Mary&#8217;s power. While power may not be a true zero-sum game, it&#8217;s close enough in some organizations that there will be people who at least subconsciously will want to reject Mary&#8217;s idea because it will reduce her power relative to their power.
</p>
<h3>What&#8217;s a manager to do?</h3>
<p>
The net result of these effect is that the perceived benefits of any new idea must be greater than they logically ought to be, and the perceived pain of adopting that new idea needs to be lower than it logically ought to be. Pure logic will not guarantee the success of most good ideas (even a lot of brilliant ideas). You need to &#8220;round up&#8221; when calculating perceived pain and &#8220;round down&#8221; when calculating perceived benefit.
</p>
<p>
The earlier you can show benefits from adopting a new idea, the better. Near-term improvement, even in small increments, will be more effective than big, but longer-term improvements. Even benefits that are peripheral to the change can be effective.  For example, consider deploying new equipment to handle a new application earlier than strictly needed; the power of giving a techie a new toy should never be underestimated.</p>
<p>
Heed the words of President Harry Truman, who said, &#8220;It is amazing what you can accomplish if you do not care who gets the credit.&#8221; Even if the idea is yours, spread the credit around; incorporate ideas from others and give them full credit. Get away from saying &#8220;me&#8221; and &#8220;I&#8221; and aim for &#8220;us&#8221; and &#8220;we.&#8221;
</p>
<p>
To quote another president, John F. Kennedy, &#8220;Victory has a thousand fathers; defeat is an orphan.&#8221; If the project succeeds, everyone will take credit, so why not give them some ahead of time? You will gain advocates and increase your chance of success. Beside, you&#8217;ll probably get some great ideas along the way.</p>
<img src="http://feeds.feedburner.com/~r/managingwriters/~4/q79yqQDOwKw" height="1" width="1"/>]]></content:encoded>
			<wfw:commentRss>http://managingwriters.com/2010/07/01/great-idea-but/feed/</wfw:commentRss>
		<slash:comments>2</slash:comments>
		<feedburner:origLink>http://managingwriters.com/2010/07/01/great-idea-but/</feedburner:origLink></item>
		<item>
		<title>Thoughts on taking a new documentation management job</title>
		<link>http://feedproxy.google.com/~r/managingwriters/~3/onACRP-bQ4U/</link>
		<comments>http://managingwriters.com/2010/06/25/thoughts-on-new-mgmt-job/#comments</comments>
		<pubDate>Fri, 25 Jun 2010 20:59:45 +0000</pubDate>
		<dc:creator>Hamilton</dc:creator>
				<category><![CDATA[Commentary]]></category>
		<category><![CDATA[management]]></category>
		<category><![CDATA[technical writing]]></category>

		<guid isPermaLink="false">http://managingwriters.com/?p=209</guid>
		<description><![CDATA[On LinkedIn, there has been an ongoing conversation about transitioning to a new job as a documentation manager. The conversation has yielded some excellent suggestions, but I&#8217;ve noticed that they were all focused inward, on the team. They include suggestions &#8230; <a href="http://managingwriters.com/2010/06/25/thoughts-on-new-mgmt-job/">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<p>
On LinkedIn, there has been an ongoing conversation about transitioning to a new job as a documentation manager. The conversation has yielded some excellent suggestions, but I&#8217;ve noticed that they were all focused inward, on the team. They include suggestions like listening to your team, instituting changes carefully and in consultation with your team, and building a partnership based on the team&#8217;s objectives.
</p>
<p>These are all good suggestions, and I wouldn&#8217;t want to suggest that you shouldn&#8217;t build a strong relationship with your new team, however, you also need to deal with the environment outside the group.
</p>
<p>
In particular, there are three more sets of interactions that will have a material effect on your success: interactions with your own manager, the managers of the teams you support, and your customers.
</p>
<ul>
<li>
<p>
<strong>Your manager:</strong> I&#8217;ve never seen a management change where the new manager&#8217;s manager didn&#8217;t want some change in the way the group was being led. (Just as a writer cannot look at another writer&#8217;s words without finding something to change; upper level managers will always want some kind of change when a new manager comes in.)
</p>
<p>
You also need to be absolutely sure that you and your manager are 100% clear on the group&#8217;s objectives and priorities.
</p>
<p>Finally, just as you need to build a relationship with your team, you need to build a relationship with your manager.
</p>
</li>
<li>
<p>
<strong>Your peer managers:</strong> You are really joining two teams, the team you manage and the team of peer managers; these are the people who manage the groups your team works with. You need to build a working relationship with them as a team, understand what they need/want from your team, and understand any problems they may be having with your team.
</p>
</li>
<li>
<p>
<strong>Your customers:</strong> You need to interact with your customers to understand their needs and concerns. While this may seem obvious, documentation managers too often treat the internal teams they support as their customers and ignore the people who actually use their documentation.</p>
<p>The other reason for placing some emphasis here is that as a new manager you have the opportunity, and obligation, to take a fresh look at what your team is doing and institute changes. But, it&#8217;s very dangerous to make changes without understanding the customer impact and their needs. Plus, you can use customer input to help drive change.
</p>
</li>
</ul>
<p>
Taking on a new job as a documentation manager is a serious challenge, and you are guaranteed to have a few bumps in the road. If you&#8217;re interacting frequently with the right people, you&#8217;ll be more likely to avoid the bumps or at least see them in time to take action.</p>
<img src="http://feeds.feedburner.com/~r/managingwriters/~4/onACRP-bQ4U" height="1" width="1"/>]]></content:encoded>
			<wfw:commentRss>http://managingwriters.com/2010/06/25/thoughts-on-new-mgmt-job/feed/</wfw:commentRss>
		<slash:comments>1</slash:comments>
		<feedburner:origLink>http://managingwriters.com/2010/06/25/thoughts-on-new-mgmt-job/</feedburner:origLink></item>
		<item>
		<title>A CMS is like a Chain Saw</title>
		<link>http://feedproxy.google.com/~r/managingwriters/~3/3iyHnBaU8Qw/</link>
		<comments>http://managingwriters.com/2010/06/24/a-cms-is-like-a-chain-saw/#comments</comments>
		<pubDate>Thu, 24 Jun 2010 06:48:30 +0000</pubDate>
		<dc:creator>Hamilton</dc:creator>
				<category><![CDATA[Commentary]]></category>
		<category><![CDATA[Content Management]]></category>
		<category><![CDATA[management]]></category>
		<category><![CDATA[technical writing]]></category>

		<guid isPermaLink="false">http://managingwriters.com/?p=201</guid>
		<description><![CDATA[A chain saw will not tell you which trees to cut or what protective gear to wear. To use one safely, you must plan your cuts, use protective gear, and take appropriate safety precautions. Anyone who has seen a chain &#8230; <a href="http://managingwriters.com/2010/06/24/a-cms-is-like-a-chain-saw/">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<p>A chain saw will not tell you which trees to cut or what protective gear to wear. To use one safely, you must plan your cuts, use protective gear, and take appropriate safety precautions.</p>
<p>Anyone who has seen a chain saw in action knows this.</p>
<p>A CMS (Content Management System) will not tell you how to organize your content or understand your processes. To use one safely, you must organize your content, understand your processes, and understand the problem(s) you want the CMS to solve.</p>
<p>Anyone in technical communication should know this.</p>
<p>The only difference is that most people know that chain saws are dangerous and plan accordingly.</p>
<img src="http://feeds.feedburner.com/~r/managingwriters/~4/3iyHnBaU8Qw" height="1" width="1"/>]]></content:encoded>
			<wfw:commentRss>http://managingwriters.com/2010/06/24/a-cms-is-like-a-chain-saw/feed/</wfw:commentRss>
		<slash:comments>1</slash:comments>
		<feedburner:origLink>http://managingwriters.com/2010/06/24/a-cms-is-like-a-chain-saw/</feedburner:origLink></item>
		<item>
		<title>Give them the objective, not the means</title>
		<link>http://feedproxy.google.com/~r/managingwriters/~3/iJGUYeNadeY/</link>
		<comments>http://managingwriters.com/2010/02/08/give-them-the-objective-not-the-means/#comments</comments>
		<pubDate>Mon, 08 Feb 2010 19:35:33 +0000</pubDate>
		<dc:creator />
				<category><![CDATA[Commentary]]></category>
		<category><![CDATA[management]]></category>
		<category><![CDATA[motivation]]></category>
		<category><![CDATA[objectives]]></category>

		<guid isPermaLink="false">http://managingwriters.com/?p=177</guid>
		<description><![CDATA[In a recent blog entry, &#8216;The relentless search for &#8220;tell me what to do,&#8221;&#8216; Seth Godin identifies a crucial tension in the manager/employee relationship. The tension is simple to explain, but hard to manage. Employees want to be told what &#8230; <a href="http://managingwriters.com/2010/02/08/give-them-the-objective-not-the-means/">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<p>
In a recent blog entry, <a href="http://sethgodin.typepad.com/seths_blog/2010/02/the-relentless-search-for-tell-me-what-to-do.html">&#8216;The relentless search for &#8220;tell me what to do,&#8221;&#8216;</a> Seth Godin identifies a crucial tension in the manager/employee relationship. The tension is simple to explain, but hard to manage. Employees want to be told what to do, which is a reasonable request. However, when managers respond to that question, they shift at least some responsibility for the outcome to themselves.
</p>
<p>
In Godin&#8217;s view, the biggest reason employees ask this question is to shift responsibility, and his response is to resist the urge to answer.
</p>
<p>
I agree, but in practice, things are not quite that simple. Managers exist at least in part to tell employees what to do. If they refuse to provide direction, they abdicate part of their responsibility. At the same time, they need to provide that direction in such a way that the employee takes responsibility for the outcome, even though (to the corporation) responsibility will still ultimately rest with the manager (the buck needs to stop somewhere).
</p>
<p>
How does a manager address these tensions? In my experience it comes down to the distinction between the objectives and the means used to reach those objectives. This is not as easy as it may seem. We regularly think of objectives as things like, &#8220;clean the floor,&#8221; &#8220;remove the appendix,&#8221; or &#8220;convert all user documentation to XML.&#8221; While these things sound like objectives, I would suggest that the real objectives in these three examples are more like the following, respectively, &#8220;limit the damage that dust in the facility can cause to people and machinery,&#8221; &#8220;avoid the potential internal infection a burst appendix would cause,&#8221; or &#8220;reduce the cost of producing both online and print documentation.&#8221;
</p>
<p>
The necessary actions may be the same in all three cases, but by dealing with the actual objectives you gain some important advantages:
</p>
<ul>
<li>Workers can select the right way to accomplish a task, for example choosing a vacuum cleaner or mop instead of a broom to minimize dust in the air.</li>
<li>Workers can suggest alternative objectives, for example maybe you could reduce the overall cost of documentation more effectively by eliminating printed documentation altogether.</li>
</ul>
<p>
In general, if your objectives embody the organization&#8217;s goals (for example, making money or saving lives) you&#8217;re headed in the right direction. Then, engage employees in determining the means used to reach those goals, giving them as much latitude as you can. Finally, get out of their way and let them own their work.</p>
<img src="http://feeds.feedburner.com/~r/managingwriters/~4/iJGUYeNadeY" height="1" width="1"/>]]></content:encoded>
			<wfw:commentRss>http://managingwriters.com/2010/02/08/give-them-the-objective-not-the-means/feed/</wfw:commentRss>
		<slash:comments>1</slash:comments>
		<feedburner:origLink>http://managingwriters.com/2010/02/08/give-them-the-objective-not-the-means/</feedburner:origLink></item>
		<item>
		<title>Update on Reference Checking</title>
		<link>http://feedproxy.google.com/~r/managingwriters/~3/_z0g5d0xR1M/</link>
		<comments>http://managingwriters.com/2009/11/04/update-on-reference-checking/#comments</comments>
		<pubDate>Wed, 04 Nov 2009 18:06:02 +0000</pubDate>
		<dc:creator />
				<category><![CDATA[Commentary]]></category>
		<category><![CDATA[hiring]]></category>
		<category><![CDATA[management]]></category>
		<category><![CDATA[technical writing]]></category>

		<guid isPermaLink="false">http://managingwriters.com/?p=170</guid>
		<description><![CDATA[After berating companies for being lax at checking references, I received my second call in under a week, after a long dry spell, which led to some further thoughts.... <a href="http://managingwriters.com/2009/11/04/update-on-reference-checking/">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<p>
After complaining about a perceived lack of reference check calls, I received the second in a week, after a long dry spell. Probably not a trend, but it was heartening to see another company checking references.
</p>
<p>
The call brought up a few additional thoughts:
</p>
<ul>
<li>I&#8217;ve noticed that when someone who worked for me years ago needs a reference, I sometimes find it harder to remember the specific assignment than to remember how well he or she did the job. I know who I can give a good recommendation to, but once or twice, I&#8217;ve fumbled the supposedly &#8220;easy&#8221; question, &#8220;what did he/she do for you?&#8221; even when I knew without a doubt that he or she did a good job on the now-forgotten assignment.</li>
<li>The most recent call came from a company that does contract services in the IT area. While I&#8217;m not currently in the market for such services, the fact that they demonstrated at least a degree of due diligence in hiring is a plus that I would consider in evaluating the company for possible work.</li>
<li>The same company send a thank you note, which in addition to being a nice gesture, provided them with an opportunity to sell their services. It&#8217;s rare that an advertisement comes across as a plus, but I admire companies that recognize the importance of spreading a wide net, as long as they don&#8217;t overdo it.</li>
<img src="http://feeds.feedburner.com/~r/managingwriters/~4/_z0g5d0xR1M" height="1" width="1"/>]]></content:encoded>
			<wfw:commentRss>http://managingwriters.com/2009/11/04/update-on-reference-checking/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		<feedburner:origLink>http://managingwriters.com/2009/11/04/update-on-reference-checking/</feedburner:origLink></item>
		<item>
		<title>Checking References</title>
		<link>http://feedproxy.google.com/~r/managingwriters/~3/Ej176BfoIY8/</link>
		<comments>http://managingwriters.com/2009/10/28/checking-references/#comments</comments>
		<pubDate>Wed, 28 Oct 2009 22:14:31 +0000</pubDate>
		<dc:creator />
				<category><![CDATA[Commentary]]></category>
		<category><![CDATA[hiring]]></category>
		<category><![CDATA[management]]></category>
		<category><![CDATA[technical writing]]></category>

		<guid isPermaLink="false">http://managingwriters.com/?p=164</guid>
		<description><![CDATA[I just got a call asking for a reference for someone who worked in my group a few years ago. I was glad to give a reference, and happy that I could give this person a good one. Surprisingly, this &#8230; <a href="http://managingwriters.com/2009/10/28/checking-references/">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<p>
I just got a call asking for a reference for someone who worked in my group a few years ago. I was glad to give a reference, and happy that I could give this person a good one.
</p>
<p>
Surprisingly, this is the first call I&#8217;ve received to check a reference in over a year. During that same year, I&#8217;ve had half a dozen people ask me if I would be a reference, and in the years before, I&#8217;ve agreed to give references to many more. Some of those requests were generic, like: &#8220;if I need a reference would you give me one?&#8221; But others were clearly specific, with the company identified. Yet, this is the first time in ages that anyone has bothered to call me to check a reference.
</p>
<p>
In my book, <a href="http://xmlpress.net/publications/managing-writers/" title="Link to Managing Writers web page">Managing Writers</a>, I stated that I only got called about half of the time. That&#8217;s clearly an overestimate at this point.<br />
</P.</p>
<p>
So why don&#8217;t more managers check references? Here&#8217;s my shot at enumerating the top reasons:
</p>
<ul>
<li>The applicant has obviously chosen references who will say good things, so why waste time listening to someone describe how wonderful the applicant is?</li>
<li>Once you&#8217;ve decided to hire someone, you just want to get on with things and not slow down the process.</li>
<li>You don&#8217;t want to take the chance of receiving information that conflicts with a decision you have already made.</li>
<li>The hiring process always seems to happen when you&#8217;re under pressure; you need someone right now, your &#8220;real&#8221; job is waiting, and you really don&#8217;t want to go out and find more people to interview if you unearth a problem with this person.</li>
</ul>
<p>
Regarding the first point, yes, you&#8217;re going to get someone that the applicant thinks will say good things about him or her. But, having called a lot of people to check references, I think it is still possible to learn important information, even from a &#8220;pre-screened&#8221; person. For example, you can check facts; what did the applicant work on? when did he or she work there? and so forth. In addition, you can often learn a lot from the way someone responds to questions. Even those who are restricted by their company to &#8220;name, rank, and serial number&#8221; answers may reveal their opinion in the way they respond.
</p>
<p>
The hiring manager I spoke with today didn&#8217;t ask anything out of the ordinary, and there was nothing out of the ordinary in my responses, but I think I made it clear that my evaluation of the candidate as an excellent technical writer was sincere and well-founded. I&#8217;m pretty sure that if I had thought otherwise, my meaning would have come through, even if I had used similar words.
</p>
<p>
The other three points, frankly, just add up to laziness. As strong as the urge may be to skip this step, there&#8217;s really no good reason for not calling references when you&#8217;re hiring. The call today took about five minutes, was cordial, and confirmed the likely perceptions of the caller. But, if it hadn&#8217;t, that one call could have saved him the trouble of hiring, and potentially firing, the wrong person. Since I like to call only when I&#8217;m ready to hire, it&#8217;s no more than a few phone calls about that one candidate. But if you don&#8217;t call, you are losing important information about one of the most important things you do as a manager (and one of the hardest things to undo).</p>
<img src="http://feeds.feedburner.com/~r/managingwriters/~4/Ej176BfoIY8" height="1" width="1"/>]]></content:encoded>
			<wfw:commentRss>http://managingwriters.com/2009/10/28/checking-references/feed/</wfw:commentRss>
		<slash:comments>4</slash:comments>
		<feedburner:origLink>http://managingwriters.com/2009/10/28/checking-references/</feedburner:origLink></item>
		<item>
		<title>Does DITA Make You Dumb?</title>
		<link>http://feedproxy.google.com/~r/managingwriters/~3/eVZ3jQhdAMA/</link>
		<comments>http://managingwriters.com/2009/10/06/does-dita-make-you-dumb/#comments</comments>
		<pubDate>Tue, 06 Oct 2009 15:26:19 +0000</pubDate>
		<dc:creator />
				<category><![CDATA[Commentary]]></category>
		<category><![CDATA[DITA]]></category>
		<category><![CDATA[management]]></category>
		<category><![CDATA[technical writing]]></category>

		<guid isPermaLink="false">http://managingwriters.com/?p=124</guid>
		<description><![CDATA[I had a twitter exchange a while back that got me thinking about DITA, structured writing, and the impact of tools on the perception of technical communicators.  The basic question was whether structured writing in general and DITA specifically are &#8230; <a href="http://managingwriters.com/2009/10/06/does-dita-make-you-dumb/">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<p>
I had a twitter exchange a while back that got me thinking about DITA, structured writing, and the impact of tools on the perception of technical communicators.  The basic question was whether structured writing in general and DITA specifically are &#8220;dumbing down&#8221; technical communication, leading to a devaluation of the field.
</p>
<p>
I end up straddling the fence here. The short answer is &#8220;no, I don&#8217;t think DITA is dumbing down technical communication.&#8221; However, introduction of technologies like DITA, if not handled well, could lead to a devaluation of the field. The danger I see is that if managers misunderstand DITA and modular technology, they may conclude that DITA will allow them to hire less-experienced, less-skilled, and less-expensive writers, which could lead to a de facto dumbing down (or a train wreck, depending on your point of view).<br />
<span id="more-124"></span>
</p>
<table style="float: right;text-align: left;width: 300px;font-size: smaller;" border="1px" cellpadding="2" cellspacing="2">
<thead>
<tr>
<td style="text-align: center"><strong>Tweets</strong></td>
</tr>
</thead>
<tbody>
<tr>
<td>BkwdGreenComet: @richardhamilton (1) Writers of DITA-based documents are filling in forms. Doc arch and org is already &#8220;solved.&#8221;</td>
</tr>
<tr>
<td>BkwdGreenComet: @richardhamilton (2) Web output from DITA will predominate, thus formatting options are limited vs traditional book output.</td>
</tr>
<tr>
<td>BkwdGreenComet: @richardhamilton (3) Prose for transitions and topic &#8220;context&#8221; is expunged to encourage content reuse.</td>
</tr>
<tr>
<td>BkwdGreenComet: @richardhamilton (4) TCer no longer need be expert on a complete sw product, only a piece. -> fragmentation of knowledge</td>
</tr>
<tr>
<td>BkwdGreenComet: @richardhamilton (5) Parts of sw product doc that gets most rewrite attention (the UI) requires least techn expertise.</td>
</tr>
</tbody>
</table>
<p>
The sidebar contains a set of tweets from Paul Sholar, better known on twitter as <a href="http://twitter.com/BkwdGreenComet" title="Paul Sholar's twitter account">@BkwdGreenComet</a>. Paul, who was kind enough to let me quote his tweets, is a thoughtful and careful commentator, so I take his thoughts seriously. He gives five reasons he sees DITA, and by implication structured writing, dumbing-down technical communication. My tweets, which in any case are not nearly as thoughtful as his, are lost in the twitter-verse because I waited too long to retrieve them, but I&#8217;ll do my best to recreate  my thoughts here.
</p>
<p>
Overall, I agree with most of Paul&#8217;s specific comments, with a caveat. I think some of them work primarily as a statement of &#8220;what managers think.&#8221; Of course, since &#8220;what managers think&#8221; often leads to &#8220;how managers act,&#8221; his points are worth taking seriously. Let&#8217;s take a look at them one by one:
</p>
<blockquote><p>(1) Writers of DITA-based documents are filling in forms. Doc arch and org is already “solved.”
</p></blockquote>
<p>
If you are &#8220;just the writer,&#8221; then you may end up in a job where it seems like you are just filling in forms, but someone still has to create a documentation architecture and organization, even if you are working in the DITA world. If you avoid being involved with the doc architecture, then you may get slotted into a position where you seem to be just filling in forms, but even the form filler needs to understand the information he or she is placing in the form.
</p>
<blockquote><p>(2) Web output from DITA will predominate, thus formatting options are limited vs traditional book output.</p></blockquote>
<p>
I agree that web output will predominate, along with help systems, but I don&#8217;t think print, or print analogs like PDFs, will disappear. Also, you can make a pretty good argument that web output has at least as wide a range of formatting options as print, even though those options don&#8217;t overlap 100%.
</p>
<p>
What really limits formatting options is that modular writing separates formatting from content, and often takes away the formatting job from the writers. While that may seem like a step backwards in terms of the skills writers need, I don&#8217;t believe it is. After all, in most corporate contexts the style is set and the job of the writer is simply to comply with that style. So, in practice formatting is often simply a rote exercise in force-fitting content into a corporate style using a WYSIWYG tool. Not by any means the most challenging skill for most technical communicators, and not one that will garner a lot of respect from managers.
</p>
<p>
Incidentally, that doesn&#8217;t mean there is no place for carefully designed and formatted content. Some content, for example quick reference cards or documents where you need to communicate complex ideas through graphic means, requires a high level of skill. However, that&#8217;s not the kind of content DITA is intended for.
</p>
<blockquote><p>(3) Prose for transitions and topic “context” is expunged to encourage content reuse.</p></blockquote>
<p>
Yup, though I would argue that this makes it harder to write in DITA, not easier. Sometimes you just need a transition, and even the DITA TC recognizes that as witnessed by the existence of the DITA publisher&#8217;s specialization, which contains some &#8220;connective tissue&#8221; for transitions.
</p>
<blockquote><p>(4) TCer no longer need be expert on a complete sw product, only a piece. -> fragmentation of knowledge</p></blockquote>
<p>
Here I have to disagree. You still need to be an expert on what you are writing about. If a technology like DITA makes you more productive (a debate I&#8217;ll leave for the future), then shouldn&#8217;t you be able to cover more territory, not less? Therefore, you might need to become expert in more areas, not fewer. Of course, a badly managed project may lead to writers being expected to cobble together documentation for some part of a product with little or no understanding of the whole, but I wouldn&#8217;t let the pathological case make the rule.
</p>
<blockquote><p>(5) Parts of sw product doc that gets most rewrite attention (the UI) requires least techn expertise.</p></blockquote>
<p>
This is a very interesting point that I&#8217;ve never fully considered, and which has merit. However, I don&#8217;t think that problem can be laid at the feet of DITA or modular documentation. That&#8217;s going to happen regardless of your methodology or tools.
</p>
<p>
So, what does it all add up to? I think the key is understanding what technology can and can&#8217;t do. There are at least two broad categories of technology that managers often confuse. The first is technology that replaces a particular skill. For example, the cash register at a McDonalds has technology that relieves cashiers from doing math, so they can hire people who are not skilled in math. The second is technology that allows a skilled practitioner to be more productive.  For example, the computer makes it possible to write and edit text much more easily than a typewriter, but it won&#8217;t make a bad writer better.
</p>
<p>
To the extent that DITA works as a technology, it clearly works in the second category. But, if managers think it also works in the first category, they will naturally try to hire less skilled writers, with bad results for both their companies and the field of technical communication. That&#8217;s where I think Paul is headed in his points, and it&#8217;s where I agree with him. Our challenge as technical communicators is to make sure our managers understand the distinction and help them see how DITA, while a potentially useful technology and methodology, is not the equivalent of a MacDonalds cash register for writers.
</p>
<p>
Thanks, Paul, for letting me deconstruct your tweets.</p>
<img src="http://feeds.feedburner.com/~r/managingwriters/~4/eVZ3jQhdAMA" height="1" width="1"/>]]></content:encoded>
			<wfw:commentRss>http://managingwriters.com/2009/10/06/does-dita-make-you-dumb/feed/</wfw:commentRss>
		<slash:comments>10</slash:comments>
		<feedburner:origLink>http://managingwriters.com/2009/10/06/does-dita-make-you-dumb/</feedburner:origLink></item>
		<item>
		<title>WebWorks RoundUp ’09</title>
		<link>http://feedproxy.google.com/~r/managingwriters/~3/xT6-83ibRuA/</link>
		<comments>http://managingwriters.com/2009/09/18/webworks-roundup-09/#comments</comments>
		<pubDate>Fri, 18 Sep 2009 20:22:41 +0000</pubDate>
		<dc:creator />
				<category><![CDATA[Conferences]]></category>
		<category><![CDATA[Webworks]]></category>

		<guid isPermaLink="false">http://managingwriters.com/?p=136</guid>
		<description><![CDATA[I am looking forward to attending WebWorks RoundUp 09 next month (Oct. 19-21, 2009) in Austin, TX. I will be participating in a panel titled, &#8220;Content Development Best Practices&#8221; with Alan J. Porter, Berry Braster, and Paul Mueller, fast company &#8230; <a href="http://managingwriters.com/2009/09/18/webworks-roundup-09/">Continue reading <span class="meta-nav">&#8594;</span></a>]]></description>
			<content:encoded><![CDATA[<p>I am looking forward to attending <a href="http://webworksroundup.com">WebWorks RoundUp 09</a> next month (Oct. 19-21, 2009) in Austin, TX. I will be participating in a panel titled, &#8220;Content Development Best Practices&#8221; with Alan J. Porter, Berry Braster, and Paul Mueller, fast company indeed.
</p>
<p>
XML Press is partnering with WebWorks to provide complementary copies of Anne Gentle&#8217;s <a href="http://xmlpress.net/conversation.html">Conversation and Community: The Social Web for Documentation</a> and my <a href="http://xmlpress.net/managingwriters.html">Managing Writers: A Real-World Guide to Managing Technical Documentation</a> for attendees. XML Press will also be giving away a copy of Alan Porter&#8217;s forthcoming book, <a href="http://xmlpress.net/publications/wiki-how-to-grow/">WIKI: Grow Your Own for Fun and Profit</a>. Plus, we will have an XML Press booth with information about our upcoming releases, book signings, and other goodies.
</p>
<p>
Overall, it looks like a great conference both for ePublisher users and anyone interested in the latest trends in technical communication and publishing. There will be keynotes by WebWorks execs Tony McDow and Alan Porter, featured talks by Stewart Mader and Tom Johnson, and panels with several groups of industry exporters. XML Press authors Anne Gentle and Alan Porter will both be speaking, and Anne and I will be available to sign our books.</p>
<img src="http://feeds.feedburner.com/~r/managingwriters/~4/xT6-83ibRuA" height="1" width="1"/>]]></content:encoded>
			<wfw:commentRss>http://managingwriters.com/2009/09/18/webworks-roundup-09/feed/</wfw:commentRss>
		<slash:comments>1</slash:comments>
		<feedburner:origLink>http://managingwriters.com/2009/09/18/webworks-roundup-09/</feedburner:origLink></item>
	</channel>
</rss>
