<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	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/"
		>
<channel>
	<title>Comments for Managing Writers</title>
	<atom:link href="http://managingwriters.com/comments/feed/" rel="self" type="application/rss+xml" />
	<link>http://managingwriters.com</link>
	<description>A Real World Guide to Managing Technical Documentation</description>
	<lastBuildDate>Thu, 29 Oct 2009 00:46:36 +0000</lastBuildDate>
	<generator>http://wordpress.org/?v=2.9.1</generator>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
		<item>
		<title>Comment on Checking References by xadmin</title>
		<link>http://managingwriters.com/2009/10/28/checking-references/comment-page-1/#comment-4607</link>
		<dc:creator>xadmin</dc:creator>
		<pubDate>Thu, 29 Oct 2009 00:46:36 +0000</pubDate>
		<guid isPermaLink="false">http://managingwriters.com/?p=164#comment-4607</guid>
		<description>Mary,

Thanks for the comment. I have worked for companies that told me to never give out more information than verification and dates of employment, though I&#039;ve never had a company tell me not to call references when hiring. BTW, I didn&#039;t exclude calls from HR, which in my memory are even more rare than calls from managers (I can&#039;t remember the last one, though in fairness, sometimes the call is from &quot;Leslie Jones of XYZ Corp.,&quot; so it could be either HR or a manager).

All that said, those kinds of restrictions make it hard to get information from references, and while I understand the legal concern, it&#039;s a real annoyance. I&#039;d like to know whether any company has suffered a significant legal problem from giving an honest reference, or if it&#039;s just lawyers putting on the belts and suspenders.

While I always did my best to follow corporate policy when giving a reference, I have received information &quot;sub rosa&quot; from companies with that policy, especially if the manager thought the candidate was someone who deserved a good reference. And, I have often been able to get a good feeling about someone&#039;s opinion through tone of voice, word choice, etc. But, it can be a real annoyance when you run into a company with that policy.</description>
		<content:encoded><![CDATA[<p>Mary,</p>
<p>Thanks for the comment. I have worked for companies that told me to never give out more information than verification and dates of employment, though I&#8217;ve never had a company tell me not to call references when hiring. BTW, I didn&#8217;t exclude calls from HR, which in my memory are even more rare than calls from managers (I can&#8217;t remember the last one, though in fairness, sometimes the call is from &#8220;Leslie Jones of XYZ Corp.,&#8221; so it could be either HR or a manager).</p>
<p>All that said, those kinds of restrictions make it hard to get information from references, and while I understand the legal concern, it&#8217;s a real annoyance. I&#8217;d like to know whether any company has suffered a significant legal problem from giving an honest reference, or if it&#8217;s just lawyers putting on the belts and suspenders.</p>
<p>While I always did my best to follow corporate policy when giving a reference, I have received information &#8220;sub rosa&#8221; from companies with that policy, especially if the manager thought the candidate was someone who deserved a good reference. And, I have often been able to get a good feeling about someone&#8217;s opinion through tone of voice, word choice, etc. But, it can be a real annoyance when you run into a company with that policy.</p>
]]></content:encoded>
	</item>
	<item>
		<title>Comment on Checking References by Mary</title>
		<link>http://managingwriters.com/2009/10/28/checking-references/comment-page-1/#comment-4605</link>
		<dc:creator>Mary</dc:creator>
		<pubDate>Wed, 28 Oct 2009 23:59:01 +0000</pubDate>
		<guid isPermaLink="false">http://managingwriters.com/?p=164#comment-4605</guid>
		<description>I was told by an HR dept many years ago to never give out any information other than to verify that the person worked there and their dates of employment. Any other information needed to be requested in writing and sent to HR. I&#039;m guessing companies that tell their employees not to give references, likely tell them not to call for references as well; any checking is left to the HR dept.</description>
		<content:encoded><![CDATA[<p>I was told by an HR dept many years ago to never give out any information other than to verify that the person worked there and their dates of employment. Any other information needed to be requested in writing and sent to HR. I&#8217;m guessing companies that tell their employees not to give references, likely tell them not to call for references as well; any checking is left to the HR dept.</p>
]]></content:encoded>
	</item>
	<item>
		<title>Comment on Checking References by xadmin</title>
		<link>http://managingwriters.com/2009/10/28/checking-references/comment-page-1/#comment-4604</link>
		<dc:creator>xadmin</dc:creator>
		<pubDate>Wed, 28 Oct 2009 23:31:42 +0000</pubDate>
		<guid isPermaLink="false">http://managingwriters.com/?p=164#comment-4604</guid>
		<description>Good point, that may be another reason for their reluctance to call. Might be worth doing a blog entry on what to ask about.</description>
		<content:encoded><![CDATA[<p>Good point, that may be another reason for their reluctance to call. Might be worth doing a blog entry on what to ask about.</p>
]]></content:encoded>
	</item>
	<item>
		<title>Comment on Checking References by Walter Hanig</title>
		<link>http://managingwriters.com/2009/10/28/checking-references/comment-page-1/#comment-4603</link>
		<dc:creator>Walter Hanig</dc:creator>
		<pubDate>Wed, 28 Oct 2009 23:27:41 +0000</pubDate>
		<guid isPermaLink="false">http://managingwriters.com/?p=164#comment-4603</guid>
		<description>I wonder if managers know what they want to learn from checking references and how to elicit that information.</description>
		<content:encoded><![CDATA[<p>I wonder if managers know what they want to learn from checking references and how to elicit that information.</p>
]]></content:encoded>
	</item>
	<item>
		<title>Comment on Does DITA Make You Dumb? by &#160; Weekly links roundup&#160;by&#160;Communications from DMN</title>
		<link>http://managingwriters.com/2009/10/06/does-dita-make-you-dumb/comment-page-1/#comment-4471</link>
		<dc:creator>&#160; Weekly links roundup&#160;by&#160;Communications from DMN</dc:creator>
		<pubDate>Fri, 16 Oct 2009 10:32:10 +0000</pubDate>
		<guid isPermaLink="false">http://managingwriters.com/?p=124#comment-4471</guid>
		<description>[...] Does DITA make you dumb? [...]</description>
		<content:encoded><![CDATA[<p>[...] Does DITA make you dumb? [...]</p>
]]></content:encoded>
	</item>
	<item>
		<title>Comment on Does DITA Make You Dumb? by xadmin</title>
		<link>http://managingwriters.com/2009/10/06/does-dita-make-you-dumb/comment-page-1/#comment-4387</link>
		<dc:creator>xadmin</dc:creator>
		<pubDate>Sat, 10 Oct 2009 17:04:00 +0000</pubDate>
		<guid isPermaLink="false">http://managingwriters.com/?p=124#comment-4387</guid>
		<description>Milan,

Absolutely true. A lot of this discussion has nothing at all to do with the quality of documentation. It&#039;s all about perception. Do managers &quot;perceive&quot; that DITA makes it possible to hire cheaper writers? Do writers perceive that DITA will narrow their field or put them in a writing straitjacket? 

That doesn&#039;t mean the discussion isn&#039;t relevant, but it does take it away from the core of what technical communicators are supposedly paid to do.</description>
		<content:encoded><![CDATA[<p>Milan,</p>
<p>Absolutely true. A lot of this discussion has nothing at all to do with the quality of documentation. It&#8217;s all about perception. Do managers &#8220;perceive&#8221; that DITA makes it possible to hire cheaper writers? Do writers perceive that DITA will narrow their field or put them in a writing straitjacket? </p>
<p>That doesn&#8217;t mean the discussion isn&#8217;t relevant, but it does take it away from the core of what technical communicators are supposedly paid to do.</p>
]]></content:encoded>
	</item>
	<item>
		<title>Comment on Does DITA Make You Dumb? by Milan Davidovic</title>
		<link>http://managingwriters.com/2009/10/06/does-dita-make-you-dumb/comment-page-1/#comment-4383</link>
		<dc:creator>Milan Davidovic</dc:creator>
		<pubDate>Sat, 10 Oct 2009 02:00:20 +0000</pubDate>
		<guid isPermaLink="false">http://managingwriters.com/?p=124#comment-4383</guid>
		<description>@Richard -- I get &quot;devaluation of the field&quot;, but I don&#039;t think that documentation quality necessarily suffers because of it. It could, but it doesn&#039;t have to.</description>
		<content:encoded><![CDATA[<p>@Richard &#8212; I get &#8220;devaluation of the field&#8221;, but I don&#8217;t think that documentation quality necessarily suffers because of it. It could, but it doesn&#8217;t have to.</p>
]]></content:encoded>
	</item>
	<item>
		<title>Comment on Does DITA Make You Dumb? by Paul K. Sholar</title>
		<link>http://managingwriters.com/2009/10/06/does-dita-make-you-dumb/comment-page-1/#comment-4380</link>
		<dc:creator>Paul K. Sholar</dc:creator>
		<pubDate>Fri, 09 Oct 2009 17:23:03 +0000</pubDate>
		<guid isPermaLink="false">http://managingwriters.com/?p=124#comment-4380</guid>
		<description>I don&#039;t agree that DITA does anything to ensure &quot;higher quality&quot; documentation or to produce documentation that &quot;look good&quot;--probably quite the contrary due to the paucity of formatting control provided by XSL-FO, compared with the previous generation of print-oriented desktop publishing tools such as FrameMaker. Rather DITA is a means to enforce a particular three-class structuring scheme for text. The quality of documentation comes from its fitness for its purpose. Regarding &quot;devaluing&quot; of documentation, I would say this is the marketplace&#039;s response to low-quality documentation. Low-quality documentation tends to correlate with poorly designed products. Low-quality documentation also tends to correlate with less skilled technical writers, regardless of product quality. My main concern with DITA, and with the topic-based model for authoring documentation, is that the scope of the tech writer&#039;s required knowledge shrinks. There is no longer the need to know the great sweep of the product&#039;s intended use. That knowledge migrates strongly back into the product development team; the old TWs must now consider moving to product development as a &quot;usability&quot; expert who may or may not have expertise in the product&#039;s functional domain. My understanding today is that &quot;usability&quot; means mostly a person who focuses on web page design and screen layout, not functional workflow; I hope I&#039;m wrong about that. If I&#039;m not wrong, I see a long future ahead of poorly designed computer products with dumbed-down technical writers struggling to write topics that, as a set, don&#039;t come close to meeting the customer&#039;s needs.</description>
		<content:encoded><![CDATA[<p>I don&#8217;t agree that DITA does anything to ensure &#8220;higher quality&#8221; documentation or to produce documentation that &#8220;look good&#8221;&#8211;probably quite the contrary due to the paucity of formatting control provided by XSL-FO, compared with the previous generation of print-oriented desktop publishing tools such as FrameMaker. Rather DITA is a means to enforce a particular three-class structuring scheme for text. The quality of documentation comes from its fitness for its purpose. Regarding &#8220;devaluing&#8221; of documentation, I would say this is the marketplace&#8217;s response to low-quality documentation. Low-quality documentation tends to correlate with poorly designed products. Low-quality documentation also tends to correlate with less skilled technical writers, regardless of product quality. My main concern with DITA, and with the topic-based model for authoring documentation, is that the scope of the tech writer&#8217;s required knowledge shrinks. There is no longer the need to know the great sweep of the product&#8217;s intended use. That knowledge migrates strongly back into the product development team; the old TWs must now consider moving to product development as a &#8220;usability&#8221; expert who may or may not have expertise in the product&#8217;s functional domain. My understanding today is that &#8220;usability&#8221; means mostly a person who focuses on web page design and screen layout, not functional workflow; I hope I&#8217;m wrong about that. If I&#8217;m not wrong, I see a long future ahead of poorly designed computer products with dumbed-down technical writers struggling to write topics that, as a set, don&#8217;t come close to meeting the customer&#8217;s needs.</p>
]]></content:encoded>
	</item>
	<item>
		<title>Comment on Does DITA Make You Dumb? by Larry Kunz</title>
		<link>http://managingwriters.com/2009/10/06/does-dita-make-you-dumb/comment-page-1/#comment-4350</link>
		<dc:creator>Larry Kunz</dc:creator>
		<pubDate>Wed, 07 Oct 2009 19:16:26 +0000</pubDate>
		<guid isPermaLink="false">http://managingwriters.com/?p=124#comment-4350</guid>
		<description>This article, and the comment from Wallis Sholar, has gotten me thinking. More here: http://www.sdiglobalsolutions.com/Default.aspx?tabid=77&amp;articleType=ArticleView&amp;articleId=45</description>
		<content:encoded><![CDATA[<p>This article, and the comment from Wallis Sholar, has gotten me thinking. More here: <a href="http://www.sdiglobalsolutions.com/Default.aspx?tabid=77&amp;articleType=ArticleView&amp;articleId=45" rel="nofollow">http://www.sdiglobalsolutions.com/Default.aspx?tabid=77&amp;articleType=ArticleView&amp;articleId=45</a></p>
]]></content:encoded>
	</item>
	<item>
		<title>Comment on What Doc Managers Look for in a Résumé by Richard Hamilton</title>
		<link>http://managingwriters.com/2009/03/04/what-doc-managers-look-for-in-a-resume/comment-page-1/#comment-4347</link>
		<dc:creator>Richard Hamilton</dc:creator>
		<pubDate>Wed, 07 Oct 2009 17:03:14 +0000</pubDate>
		<guid isPermaLink="false">http://rlhamilton.wordpress.com/?p=153#comment-4347</guid>
		<description>MM,

If I&#039;m evaluating the resume of someone who claims to be an expert in layout/design or in the particular tool the resume was written in, then I will look at those things. I will also in most cases consider the overall look of the resume; after all, it&#039;s easy to get an acceptable look from any word processor, so there&#039;s no excuse for having a truly ugly resume. 

At the same time, for writers, I&#039;m much more interested in the structure and writing. Chance are they will be using a corporate style guide that will make any design skills moot. Yes, if the resume was written using the tool that person will need to use on the job, I may dive deeper, but that will only happen for candidates I&#039;m serious about interviewing.

Regarding the second part, I do expect technical writers to use styles and clean formatting when using tools that allow it. Most of my recent teams have used XML, so I&#039;m more concerned about good semantic markup. But for a job that uses Word or asimilar word processor, I expect them to use the styles and formatting defined by whatever style guide we are using.

All that said, if you can&#039;t write, I don&#039;t care how well you format, I&#039;m not interested.</description>
		<content:encoded><![CDATA[<p>MM,</p>
<p>If I&#8217;m evaluating the resume of someone who claims to be an expert in layout/design or in the particular tool the resume was written in, then I will look at those things. I will also in most cases consider the overall look of the resume; after all, it&#8217;s easy to get an acceptable look from any word processor, so there&#8217;s no excuse for having a truly ugly resume. </p>
<p>At the same time, for writers, I&#8217;m much more interested in the structure and writing. Chance are they will be using a corporate style guide that will make any design skills moot. Yes, if the resume was written using the tool that person will need to use on the job, I may dive deeper, but that will only happen for candidates I&#8217;m serious about interviewing.</p>
<p>Regarding the second part, I do expect technical writers to use styles and clean formatting when using tools that allow it. Most of my recent teams have used XML, so I&#8217;m more concerned about good semantic markup. But for a job that uses Word or asimilar word processor, I expect them to use the styles and formatting defined by whatever style guide we are using.</p>
<p>All that said, if you can&#8217;t write, I don&#8217;t care how well you format, I&#8217;m not interested.</p>
]]></content:encoded>
	</item>
</channel>
</rss>
