<?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"
	>
<channel>
	<title>Comments on: The agile technical writer</title>
	<atom:link href="http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/feed/" rel="self" type="application/rss+xml" />
	<link>http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/</link>
	<description>A technical writer's blog on Wordpress</description>
	<pubDate>Sat, 19 Jul 2008 12:12:56 +0000</pubDate>
	<generator>http://wordpress.org/?v=MU</generator>
		<item>
		<title>By: Jewell</title>
		<link>http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1476</link>
		<dc:creator>Jewell</dc:creator>
		<pubDate>Wed, 11 Jun 2008 00:17:13 +0000</pubDate>
		<guid isPermaLink="false">http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1476</guid>
		<description>Thank you so much.  I really do love the work and appreciate the encouragement. 

The only other frustration I have is that I am female and find that the men I work under typically do not believe I understand technical material, despite my certification as an electronic technician and my education, which includes Physics and Calculus.</description>
		<content:encoded><![CDATA[<p>Thank you so much.  I really do love the work and appreciate the encouragement. </p>
<p>The only other frustration I have is that I am female and find that the men I work under typically do not believe I understand technical material, despite my certification as an electronic technician and my education, which includes Physics and Calculus.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: ffeathers</title>
		<link>http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1475</link>
		<dc:creator>ffeathers</dc:creator>
		<pubDate>Tue, 10 Jun 2008 22:06:16 +0000</pubDate>
		<guid isPermaLink="false">http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1475</guid>
		<description>Hallo Jewell

Two documents, each 150 pages long, is a big task. It's hard to say how long such a review and completion job would take, without knowing the original quality of the document. At a stab, I'd guess 3 weeks for each document, assuming the original quality is fairly good.

My experience is that management and non-tech-writers consistently under-estimate the amount of time it takes to produce a quality document. They simply don't know.

A suggestion: Now that you've had some good exposure to the documentation task, it would be a good time to make some estimates for the time required to complete the job. Base your estimates on the time you've spent so far (known) and add the time still required (estimate). Be ruthless about the time still required --- don't cut it short. And add a good section of time for reviews once you're done.

This will put you in good stead for the next task they might present, because you'd have a good basis to set their expectations.

I guess the most important thing about extending your position there is whether you enjoy the work and the people. If those two things are good, then everything else kind of falls into place :)

In short: No, you're not too slow.  :)

Good luck, and let us know how it goes.
Sarah</description>
		<content:encoded><![CDATA[<p>Hallo Jewell</p>
<p>Two documents, each 150 pages long, is a big task. It&#8217;s hard to say how long such a review and completion job would take, without knowing the original quality of the document. At a stab, I&#8217;d guess 3 weeks for each document, assuming the original quality is fairly good.</p>
<p>My experience is that management and non-tech-writers consistently under-estimate the amount of time it takes to produce a quality document. They simply don&#8217;t know.</p>
<p>A suggestion: Now that you&#8217;ve had some good exposure to the documentation task, it would be a good time to make some estimates for the time required to complete the job. Base your estimates on the time you&#8217;ve spent so far (known) and add the time still required (estimate). Be ruthless about the time still required &#8212; don&#8217;t cut it short. And add a good section of time for reviews once you&#8217;re done.</p>
<p>This will put you in good stead for the next task they might present, because you&#8217;d have a good basis to set their expectations.</p>
<p>I guess the most important thing about extending your position there is whether you enjoy the work and the people. If those two things are good, then everything else kind of falls into place <img src='http://s.wordpress.com/wp-includes/images/smilies/icon_smile.gif' alt=':)' class='wp-smiley' /> </p>
<p>In short: No, you&#8217;re not too slow.  <img src='http://s.wordpress.com/wp-includes/images/smilies/icon_smile.gif' alt=':)' class='wp-smiley' /> </p>
<p>Good luck, and let us know how it goes.<br />
Sarah</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Jewell</title>
		<link>http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1470</link>
		<dc:creator>Jewell</dc:creator>
		<pubDate>Tue, 10 Jun 2008 00:47:04 +0000</pubDate>
		<guid isPermaLink="false">http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1470</guid>
		<description>Hello

I am looking for a little guidance.  I have been a tech writer for about 3 years.  I like the work, but I sometimes wonder how good/productive/effective I am.  

Exactly five weeks ago, I began a contract position for a large comapany.  I love the people and the company.  In the second week, I was given two assignments.  Both are instructions for manufacturing electronic equipment and are about 150 pages long.  One was an original document that I was told was 95% complete.  I have gone through two sets of redlines with the SME, updated the formating, taken two sets of pictures and still need more.  I have also been told that the reference numbers for the parts are wrong and need to be changed.  While this document was in review, I worked on the second document, which was only supposed to be a revision.  It also needed format revisions and style updates.  Neither document is complete.  The second is in review with the SME, but I don't think it is finished.  Am I too slow?

I really would like to make this permanent, but worry that my efficiency is not as good as they had hoped.  Can someone with experience, who is not competing for my job, please help me?</description>
		<content:encoded><![CDATA[<p>Hello</p>
<p>I am looking for a little guidance.  I have been a tech writer for about 3 years.  I like the work, but I sometimes wonder how good/productive/effective I am.  </p>
<p>Exactly five weeks ago, I began a contract position for a large comapany.  I love the people and the company.  In the second week, I was given two assignments.  Both are instructions for manufacturing electronic equipment and are about 150 pages long.  One was an original document that I was told was 95% complete.  I have gone through two sets of redlines with the SME, updated the formating, taken two sets of pictures and still need more.  I have also been told that the reference numbers for the parts are wrong and need to be changed.  While this document was in review, I worked on the second document, which was only supposed to be a revision.  It also needed format revisions and style updates.  Neither document is complete.  The second is in review with the SME, but I don&#8217;t think it is finished.  Am I too slow?</p>
<p>I really would like to make this permanent, but worry that my efficiency is not as good as they had hoped.  Can someone with experience, who is not competing for my job, please help me?</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Being a Technical Writer in Shanghai/China &#124; Shanghai Tech Writer</title>
		<link>http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1386</link>
		<dc:creator>Being a Technical Writer in Shanghai/China &#124; Shanghai Tech Writer</dc:creator>
		<pubDate>Tue, 06 May 2008 13:28:40 +0000</pubDate>
		<guid isPermaLink="false">http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1386</guid>
		<description>[...] as a technical writer. I&#8217;ve read about the typical day of a technical writer from the U.S., Australia, the U.K., and . . . China (me)! Despite the fact that we live in different parts of the world, our [...]</description>
		<content:encoded><![CDATA[<p>[...] as a technical writer. I&#8217;ve read about the typical day of a technical writer from the U.S., Australia, the U.K., and . . . China (me)! Despite the fact that we live in different parts of the world, our [...]</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: ffeathers</title>
		<link>http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1321</link>
		<dc:creator>ffeathers</dc:creator>
		<pubDate>Wed, 26 Mar 2008 21:16:08 +0000</pubDate>
		<guid isPermaLink="false">http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1321</guid>
		<description>Hallo Limor

Thank you for your comments :) 

And a &lt;b&gt;huge&lt;/b&gt; congratulations on winning the the STC's Award of Excellence for the Gigaspaces documentation wiki! 

A team of one, that's impressive. I'm thinking you must be very agile indeed and can surely claim the magic 'XTW' acronym.

Seeya on the page, 
Sarah</description>
		<content:encoded><![CDATA[<p>Hallo Limor</p>
<p>Thank you for your comments <img src='http://s.wordpress.com/wp-includes/images/smilies/icon_smile.gif' alt=':)' class='wp-smiley' /> </p>
<p>And a <b>huge</b> congratulations on winning the the STC&#8217;s Award of Excellence for the Gigaspaces documentation wiki! </p>
<p>A team of one, that&#8217;s impressive. I&#8217;m thinking you must be very agile indeed and can surely claim the magic &#8216;XTW&#8217; acronym.</p>
<p>Seeya on the page,<br />
Sarah</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Limor Maayan</title>
		<link>http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1318</link>
		<dc:creator>Limor Maayan</dc:creator>
		<pubDate>Wed, 26 Mar 2008 09:57:11 +0000</pubDate>
		<guid isPermaLink="false">http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1318</guid>
		<description>Hi Sarah,

I just wanted to wow your blog. I've only read 2 entries, and already I've been nodding my head the whole time.

Seems that, I too am an agile technical writer, or more accurately am in the midst of becoming one (but that's agile for you, isn't it? :)).

Anyway, be sure I'll continue reading. A lot of thing you're writing hit home, since GigaSpaces also works according to Agile practices, and we also have wiki-based documentation. However, "we" are still a team of one, so I'm still trying to keep up with the R&#38;Ds crazy progress. All the things you manage to fit in to one day are quite admirable. 

Thanks for the reading, continuing to do ATW (since I'm not sure if I'm a XTW yet) stuff.

Good day,

Limor</description>
		<content:encoded><![CDATA[<p>Hi Sarah,</p>
<p>I just wanted to wow your blog. I&#8217;ve only read 2 entries, and already I&#8217;ve been nodding my head the whole time.</p>
<p>Seems that, I too am an agile technical writer, or more accurately am in the midst of becoming one (but that&#8217;s agile for you, isn&#8217;t it? :)).</p>
<p>Anyway, be sure I&#8217;ll continue reading. A lot of thing you&#8217;re writing hit home, since GigaSpaces also works according to Agile practices, and we also have wiki-based documentation. However, &#8220;we&#8221; are still a team of one, so I&#8217;m still trying to keep up with the R&amp;Ds crazy progress. All the things you manage to fit in to one day are quite admirable. </p>
<p>Thanks for the reading, continuing to do ATW (since I&#8217;m not sure if I&#8217;m a XTW yet) stuff.</p>
<p>Good day,</p>
<p>Limor</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: &#160; Weekly link roundup&#160;by&#160;Communications from DMN</title>
		<link>http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1277</link>
		<dc:creator>&#160; Weekly link roundup&#160;by&#160;Communications from DMN</dc:creator>
		<pubDate>Sat, 23 Feb 2008 12:45:15 +0000</pubDate>
		<guid isPermaLink="false">http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1277</guid>
		<description>[...] Sarah Maddox writes about being an agile technical writer. [...]</description>
		<content:encoded><![CDATA[<p>[...] Sarah Maddox writes about being an agile technical writer. [...]</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: A Glimpse into the World of Agile Technical Writing, a.k.a. Extreme Technical Writing (XTW) &#124; I'd Rather Be Writing</title>
		<link>http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1272</link>
		<dc:creator>A Glimpse into the World of Agile Technical Writing, a.k.a. Extreme Technical Writing (XTW) &#124; I'd Rather Be Writing</dc:creator>
		<pubDate>Wed, 20 Feb 2008 06:00:54 +0000</pubDate>
		<guid isPermaLink="false">http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1272</guid>
		<description>[...] The Agile Technical Writer (I) [...]</description>
		<content:encoded><![CDATA[<p>[...] The Agile Technical Writer (I) [...]</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: How to be an Agile Technical Writer with a cool acronym like XTW &#171; just write click</title>
		<link>http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1268</link>
		<dc:creator>How to be an Agile Technical Writer with a cool acronym like XTW &#171; just write click</dc:creator>
		<pubDate>Tue, 19 Feb 2008 22:05:36 +0000</pubDate>
		<guid isPermaLink="false">http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1268</guid>
		<description>[...] The agile technical writer is the first post, and it has a great description of daily life as a technical writer. [...]</description>
		<content:encoded><![CDATA[<p>[...] The agile technical writer is the first post, and it has a great description of daily life as a technical writer. [...]</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Julia</title>
		<link>http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1251</link>
		<dc:creator>Julia</dc:creator>
		<pubDate>Sun, 20 Jan 2008 19:54:48 +0000</pubDate>
		<guid isPermaLink="false">http://ffeathers.wordpress.com/2008/01/20/the-agile-technical-writer/#comment-1251</guid>
		<description>Interesting post. It's got me thinking on how the handle my next round of updating design document templates. Because our SDLC is quite unique, and we're not ready to move to an Agile method, it's interesting trying to get this type of thing done. However your comment about "This is what's working for us right now" has got me thinking. Because I'm already working on redoing our internal wikis, I've been toying with the idea of using them to explain the "templates", which are more like "guidelines" and "things to consider" when they're being written. Sometimes my non-TW colleagues tend to think "template" is something that's firm and can't be changed, even when I tell them that it is more of a guideline than anything else. I just want them to write things down! :-) So I'll be keeping this whole "use the wiki for templates, and call them guidelines instead" in mind in the next couple of weeks. May help us out.

(And sorry if this post is somewhat rambling...I'm just too tired from life to go back and redo it. :-) ) Cheers.</description>
		<content:encoded><![CDATA[<p>Interesting post. It&#8217;s got me thinking on how the handle my next round of updating design document templates. Because our SDLC is quite unique, and we&#8217;re not ready to move to an Agile method, it&#8217;s interesting trying to get this type of thing done. However your comment about &#8220;This is what&#8217;s working for us right now&#8221; has got me thinking. Because I&#8217;m already working on redoing our internal wikis, I&#8217;ve been toying with the idea of using them to explain the &#8220;templates&#8221;, which are more like &#8220;guidelines&#8221; and &#8220;things to consider&#8221; when they&#8217;re being written. Sometimes my non-TW colleagues tend to think &#8220;template&#8221; is something that&#8217;s firm and can&#8217;t be changed, even when I tell them that it is more of a guideline than anything else. I just want them to write things down! <img src='http://s.wordpress.com/wp-includes/images/smilies/icon_smile.gif' alt=':-)' class='wp-smiley' /> So I&#8217;ll be keeping this whole &#8220;use the wiki for templates, and call them guidelines instead&#8221; in mind in the next couple of weeks. May help us out.</p>
<p>(And sorry if this post is somewhat rambling&#8230;I&#8217;m just too tired from life to go back and redo it. <img src='http://s.wordpress.com/wp-includes/images/smilies/icon_smile.gif' alt=':-)' class='wp-smiley' /> ) Cheers.</p>
]]></content:encoded>
	</item>
</channel>
</rss>
