<?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>Just Write Click &#187; content</title>
	<atom:link href="http://justwriteclick.com/tag/content/feed/" rel="self" type="application/rss+xml" />
	<link>http://justwriteclick.com</link>
	<description>Documentation as conversation</description>
	<lastBuildDate>Tue, 09 Mar 2010 15:54:53 +0000</lastBuildDate>
	<generator>http://wordpress.org/?v=2.9</generator>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
			<item>
		<title>Content tidbits from a Community Roundtable report</title>
		<link>http://justwriteclick.com/2010/03/04/content-tidbits-from-a-community-roundtable-report/</link>
		<comments>http://justwriteclick.com/2010/03/04/content-tidbits-from-a-community-roundtable-report/#comments</comments>
		<pubDate>Thu, 04 Mar 2010 11:57:16 +0000</pubDate>
		<dc:creator>annegentle</dc:creator>
				<category><![CDATA[social media]]></category>
		<category><![CDATA[community]]></category>
		<category><![CDATA[content]]></category>
		<category><![CDATA[strategy]]></category>

		<guid isPermaLink="false">http://justwriteclick.com/?p=1408</guid>
		<description><![CDATA[I&#8217;m reading (with vigor!) the The State of Community Management Report: Best Practices from Community Practitioners
from the Community Roundtable, and finding so many wonderful tips about content from people who are community managers. I had to start a list of items that are relevant to technical communication and web writing to share. I naturally tend [...]]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;"><a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fjustwriteclick.com%2F2010%2F03%2F04%2Fcontent-tidbits-from-a-community-roundtable-report%2F"><img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fjustwriteclick.com%2F2010%2F03%2F04%2Fcontent-tidbits-from-a-community-roundtable-report%2F" height="61" width="51" /></a></div><p><a href="http://www.flickr.com/photos/ladymixy-uk/4063190551/"><img class="alignleft size-medium wp-image-1411" style="margin: 10px;" title="archery arrows" src="http://justwriteclick.com/blog/wp-content/uploads/2010/03/archeryarrows-300x199.jpg" alt="Photo courtesy M i x y on Flickr using the CC By 2.0 license" width="300" height="199" /></a>I&#8217;m reading (with vigor!) the <a href="http://community-roundtable.com/socm-2010/">The State of Community Management Report: Best Practices from Community Practitioners<br />
from the Community Roundtable</a>, and finding so many wonderful tips about content from people who are community managers. I had to start a list of items that are relevant to technical communication and web writing to share. I naturally tend to target technical communications when I interpret the report, but this report is rife with content strategy.</p>
<p>I agree with this statement, and I think it means a positive impact on technical writers and web writers who are paid to create content by businesses.</p>
<blockquote><p>The percentage of content that is desirable and<br />
feasible to be formally produced versus community-generated<br />
will have a big impact on resource and<br />
budget planning. This aspect is likely to change – often<br />
dramatically – over time, although it should not be<br />
assumed that content should ever be exclusively<br />
community-generated.</p></blockquote>
<p>I personally haven&#8217;t found that completely community-generated documentation will serve most business goals. In the case of <a href="http://flossmanuals.net">FLOSS Manuals</a>, though, the community-generated content meets the main purpose of supporting and documenting  open source software. Still, hiring professional writers makes sense when you need to create content that meets very specific goals for a community, whether your goals are raising awareness, troubleshooting, or learning.</p>
<p>Now, this particular comment puts a bit of a stake in the heart of technical communication&#8217;s beloved single sourcing. I like the idea of associated content for technical writers to create. It&#8217;s branching into new media, such as audio or video, while still valuing the technical content that you work so hard to create. It&#8217;s not that one births the other, but rather the two types can compliment each other.</p>
<blockquote><p>Instead of directly repurposing content from one format to another, create<br />
associated content. For example, instead of turning a white paper into an<br />
audio transcript, create a podcast discussion about it with the author.</p></blockquote>
<p>Another line that causes me to press pause and ponder for a bit:</p>
<blockquote><p>People seldom form relationships with text alone.</p></blockquote>
<p>Instead, offer images, video, or music as part of the user experience in order to grow relationships. Fascinating.</p>
<p>And finally, the one that might be the toughest for professional writers, copy editors, and technical communicators to accept:</p>
<blockquote><p>Learn to accept imperfection. Concentrate on making content interesting<br />
and relevant rather than perfect. Imperfection actually allows community<br />
members to better relate to it and engage with it.</p></blockquote>
<p>And with striving towards imperfection as my excuse, I&#8217;ll close out this blog entry and encourage you to read the report for yourself, drawing your own arrows from the quiver and targeting what is important to you.</p>
]]></content:encoded>
			<wfw:commentRss>http://justwriteclick.com/2010/03/04/content-tidbits-from-a-community-roundtable-report/feed/</wfw:commentRss>
		<slash:comments>3</slash:comments>
		</item>
		<item>
		<title>DITA for Publishers with Eliot Kimber</title>
		<link>http://justwriteclick.com/2010/02/25/dita-for-publishers-with-eliot-kimber/</link>
		<comments>http://justwriteclick.com/2010/02/25/dita-for-publishers-with-eliot-kimber/#comments</comments>
		<pubDate>Thu, 25 Feb 2010 05:32:46 +0000</pubDate>
		<dc:creator>annegentle</dc:creator>
				<category><![CDATA[social media]]></category>
		<category><![CDATA[content]]></category>
		<category><![CDATA[DITA]]></category>
		<category><![CDATA[epub]]></category>
		<category><![CDATA[iPad]]></category>
		<category><![CDATA[kindle]]></category>
		<category><![CDATA[publishers]]></category>

		<guid isPermaLink="false">http://justwriteclick.com/?p=1390</guid>
		<description><![CDATA[For this month&#8217;s Central Texas DITA User Group meeting we played host to Eliot Kimber. I took some scattered notes, mostly jotting down the great phrases Eliot handed out while nodding and chuckling.
He&#8217;ll be doing this presentation as a webinar for Really Strategies, Inc. on March 10th, and you can sign up on the Really [...]]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;"><a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fjustwriteclick.com%2F2010%2F02%2F25%2Fdita-for-publishers-with-eliot-kimber%2F"><img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fjustwriteclick.com%2F2010%2F02%2F25%2Fdita-for-publishers-with-eliot-kimber%2F" height="61" width="51" /></a></div><p>For this month&#8217;s<a href="http://dita.xml.org/book/central-texas-dita-user-group"> Central Texas DITA User Group meeting</a> we played host to Eliot Kimber. I took some scattered notes, mostly jotting down the great phrases Eliot handed out while nodding and chuckling.</p>
<p>He&#8217;ll be doing this presentation as a webinar for Really Strategies, Inc. on March 10th, and you can <a href="http://www.reallysi.com/webinars2010.htm">sign up on the Really Strategies website</a>.</p>
<p>Eliot is explaining why DITA makes sense for publishing outside of tech comm &#8211; because most all publishers need to get ePub out of their legacy content. NEED.</p>
<p>DITA should take over everything &#8211; Eliot has an evil plan. He tries not to put his pinky to his chin, though. He uses strong statements, though, like:</p>
<p>&#8220;No reason to choose any other XML standard but DITA.&#8221;</p>
<p>DITA for Publishers is built on/with/using:</p>
<ul>
<li>Topic types: article, chapter, subsection, sidebar, part</li>
<li>Map domain: pubmap</li>
<li>MS Word to DITA framework &#8211; XSLT-based framework</li>
<li>ePub transform for Open Toolkit</li>
<li>Pubmamp support for PDF transform, which enables creating quick drafts for review while people offshore the XML-izing of the content</li>
</ul>
<p>Example of just how exacting and demanding editors at publishers can be: Quark to Indesign migration blocker (years ago) was that a particular hyphen character wasn&#8217;t automatic with Indesign.</p>
<p>Eliot on publishers deciding to go with XML: &#8220;If they&#8217;re really lucky, they have an IT group that won&#8217;t help them with decisions on XML solutions.&#8221;</p>
<p>What Publishers need that DITA brings: (bold emphasis mine)</p>
<ul>
<li> Low <strong>cost </strong>of entry for sophisticated XML solutions</li>
<li> Blind <strong>interchange </strong>of content</li>
<li> <strong>Flex</strong>ible markup design</li>
<li> Strong support for modularity and <strong>reuse</strong></li>
<li><strong> </strong>Wide support by <strong>free</strong> and commercial tools</li>
</ul>
<p>He got tired of reinventing the same thing over and over &#8211; DITA for Publishers makes his implementation job easier &#8211; more clients farther along a path of success.</p>
<p>Doesn&#8217;t DITA require modular writing?<br />
- No</p>
<p>Most people implementing DITA have one topic, one file &#8211; but that is not necessary &#8211; he could have an entire book as a single XML document with one root &#8220;topic.&#8221;</p>
<p>Who&#8217;s using DITA for Publishers?<br />
- ASTD is using it for their publishing of books and magazines<br />
- Upper Room &#8211; Methodist church &#8211; publishing arm of major No. American church for books and magazines<br />
- Publisher of test preparation manuals &#8211; including TAKS test &#8211; using learning and training specializations for test questions as well<br />
- Any Really Strategies client who doesn&#8217;t already have schemas (or who is willing to migrate to a DITA-based solution)<br />
He usually can get at least one output that they can&#8217;t currently get out of their current XML schemas</p>
<p>Publications are very simple &#8211; except when they&#8217;re not. One differentiator that publishers can use is the design of the book &#8211; unique, attention-getting designs are valued.</p>
<p>DITA enables iterative design and development &#8211; when you come across something more sophisticated than the &#8220;norm&#8221; you just keep adding features &#8211; and interchange is always ensured.</p>
<p>Map / Content distinction is essential &#8211; chapter, sections, subsections, but publication structures can be very complicated with appendices, glossaries, indexes. Maps can impose the semantic meaning within the context of a map structure. So you may have one kind of division element, but 18 kinds of topic reference (yow, but that makes sense.) Means he can convert easier to generic topics, but add sophistication through the map.</p>
<p>Lots of publishing content is highly modular -</p>
<p>examples:<br />
magazine articles &#8211; reusable, valuable, can send through email, post to web<br />
encyclopedias<br />
travel and nature guides &#8211; can be recombined in interesting ways to provide additional value &#8211; also batch consistency over a large number of pubs makes sense (automated composition is a-okay)<br />
Dictionaries<br />
Newspapers<br />
Sidebars &#8211; by its nature it&#8217;s a standalone thing<br />
Educational materials such as textbooks<br />
Standards &#8211; people make money publishing info about accounting standards, for example</p>
<p>Business rules apply to element types in their CMS &#8211; so there&#8217;s a practical aspect to article, chapter, subsection, sidebar and their nesting</p>
<p>Bookmap is way too limited for technical manuals that don&#8217;t conform to IBM standards</p>
<p>Bookmap doesn&#8217;t give publishers what they need, so he built a publication map domain &#8211; provides more structuring options, more licensing options (nothing to do with copyright), he can also mix it in with other map domains, e.g. learningMap</p>
<p>structural module vs domain module &#8211; you can pick and choose in a domain module the things that are specifically useful</p>
<p>Provides publishing-specific structures, such as &#8220;page&#8221; &#8211; can have a topic with an empty title element</p>
<p>Publishing domains:<br />
+ Formatting domain<br />
- supports capturing of arbitrary formatting (example: 9th grade biology text book &#8211; lots of nutty formatting)<br />
- Integrates MathML<br />
-Can embed raw InDesign interchange data<br />
+ Pub content domain &#8211; elements contained in typical publications, e.g. epigram<br />
+ Verse domain: markup for poetry<br />
+ Classification domain: container for classifying metadata (specific taxonomy, Upper Room has this for all the ways their content relates to the domain of spiritual &#8220;stuff&#8221; he used a DITA map for the taxonomy)</p>
<p>General purpose Docx to DITA XSLT transform &#8211; authors are writing magazine articles in Word and then submitting. Transform configured by separate style-to-tag mapping. Everything from magazine articles to entire course scripts, all with different configuration parameters. Must have consistently tagged styles in the Word document.</p>
<p>XML-first workflows are pretty rare in the publishing industry among publishers.</p>
<p>Too much variablity in the business process &#8211; eight different biz processes through which they get books to publish at an association, for example.</p>
<p>Typify can &#8220;remember&#8221; where things came from and automate composition, but it costs a bunch.</p>
<p>DITA to InCopy generates InCopy articles from DITA topics &#8211; InCopy is used for manuscript preparation (writing with no layout).</p>
<p>The ePub open toolkit plugin generates HTML-based ePub packages from maps<br />
Uses output of the base XHTML transformation type</p>
<p>What he wants to continue after DITA 1.2 is done:<br />
- Documentation of vocabulary modules<br />
- Refinement and extension of tools an infrastructure</p>
<p>Community of DITA for Publishers users is building &#8211; he wants to propose it as a DITA Subcommittee once he gets enough community behind it.</p>
]]></content:encoded>
			<wfw:commentRss>http://justwriteclick.com/2010/02/25/dita-for-publishers-with-eliot-kimber/feed/</wfw:commentRss>
		<slash:comments>3</slash:comments>
		</item>
		<item>
		<title>Workin&#8217; on a Content Farm</title>
		<link>http://justwriteclick.com/2010/02/17/workin-on-a-content-farm/</link>
		<comments>http://justwriteclick.com/2010/02/17/workin-on-a-content-farm/#comments</comments>
		<pubDate>Wed, 17 Feb 2010 05:15:34 +0000</pubDate>
		<dc:creator>annegentle</dc:creator>
				<category><![CDATA[tools]]></category>
		<category><![CDATA[work]]></category>
		<category><![CDATA[writing]]></category>
		<category><![CDATA[authoring]]></category>
		<category><![CDATA[content]]></category>
		<category><![CDATA[content farm]]></category>
		<category><![CDATA[future]]></category>
		<category><![CDATA[SEO]]></category>
		<category><![CDATA[trends]]></category>

		<guid isPermaLink="false">http://justwriteclick.com/?p=1382</guid>
		<description><![CDATA[I finally did it, I wrote my first article for the Demand Studios content farm site, eHow. I wasn&#8217;t playing the part of a content farmer, though, but rather a farm worker, writing an article for little pay (compared to other rates I have earned as a professional writer).
I signed up for Demand Studios a [...]]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;"><a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fjustwriteclick.com%2F2010%2F02%2F17%2Fworkin-on-a-content-farm%2F"><img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fjustwriteclick.com%2F2010%2F02%2F17%2Fworkin-on-a-content-farm%2F" height="61" width="51" /></a></div><p>I finally did it, I wrote my first article for the Demand Studios content farm site, eHow. I wasn&#8217;t playing the part of a content farmer, though, but rather a farm worker, writing an article for little pay (compared to other rates I have earned as a professional writer).</p>
<p>I signed up for Demand Studios a few months back. There is a company called <a href="http://mashable.com/2008/03/04/demand-acquires-pluck/">Pluck here in Austin that was acquired by Demand Media in the spring of 2008</a>. What drew me to them in particular was not only the local connection, but also a fascination with turning search engine optimization on its ear. I first learned of these methods for content creation from this Wired article, <a href="http://www.wired.com/magazine/2009/10/ff_demandmedia/">The Answer Factory: Demand Media and the Fast, Disposable, and Profitable as Hell Media Model</a>. Basically Demand Studios analyzes what phrases are searched for and then enter an article request in their database. There are currently 15,000 articles waiting to be written in their system. The pay for those articles is from $15 to $7.50 or less, and there are some assignments that offer profit sharing based on the numbers of views, apparently.</p>
<p>As a pro writer, I was dead set on following the style guide, knowing that attentiveness to the guidance given is part of the battle in producing good content. In their system, when I &#8220;Claimed&#8221; the article, it wasn&#8217;t immediately apparent which template I would be writing to, which made me a little nervous about attempting it in the first place. After clicking the article to claim it, though, I found that it was the About template. The guidelines were very clear &#8211; the About type required five sections with one-word section headers and the first section had to be titled Overview and contain about 75 words. The rest of the sections could contain more than 75 words but at least 50 words were necessary, and overall the article was targeted for 400-500 words. Quite structured.</p>
<p>The web-based authoring forms were easy to use, though it did not include a word count. I found it easier to get word counts in Textpad and then copy/paste the text into each section.</p>
<p>They&#8217;ve also very recently introduced an image library that you can search for images, the use of which is encouraged. You could add an image to each of the sections if you wanted. To my poorly trained eye, they seemed adequate but not too glossy, and none of my searches found quite the perfect image, but I included two anyway. They intend to allow people to upload their own photos, which I would have done in a heartbeat as I had one or two that would have been just right.</p>
<p>To my relief, the article I submitted by  noon on a week day was approved by early morning the next week day.</p>
<p>It took me about 2.5 hours to write a 500 word article, I&#8217;m not proud to admit (or perhaps I should be proud of the quality that comes at that speed?) So my hourly rate for the article was right around $6.00 per hour. At least I didn&#8217;t have rewrites (she says sheepishly.)</p>
<p>To reflect back, I did the article because I wanted to see what the authoring system was like, and experience for myself the process of writing in such a system. To be sure, it&#8217;s easy to demonize such a system when you&#8217;re accustomed to higher pay for content creation. There&#8217;s a great <a href="http://www.readwriteweb.com/archives/jay_rosen_vs_demand_media_are_content_farms_demoni.php">interview on ReadWriteWeb by Jay Rosen, who talked with Demand Media founder and CEO Richard Rosenblatt</a>, and it offers both sides of the issues surrounding content collection and the future of the web. I don&#8217;t want to take sides by sharing my experience. I just wanted to collect information based on the writer&#8217;s experience.</p>
<p>What do you think? Are content farms cluttering the web and driving down writer&#8217;s pay? Or is there an entrepreneurial opportunity here that offers a low barrier to entry for content creators any where to earn pay for  populating the web with content that&#8217;s already being searched for?</p>
]]></content:encoded>
			<wfw:commentRss>http://justwriteclick.com/2010/02/17/workin-on-a-content-farm/feed/</wfw:commentRss>
		<slash:comments>14</slash:comments>
		</item>
		<item>
		<title>Pilot or not?</title>
		<link>http://justwriteclick.com/2010/01/12/pilot-or-not/</link>
		<comments>http://justwriteclick.com/2010/01/12/pilot-or-not/#comments</comments>
		<pubDate>Tue, 12 Jan 2010 21:21:28 +0000</pubDate>
		<dc:creator>annegentle</dc:creator>
				<category><![CDATA[social media]]></category>
		<category><![CDATA[wiki]]></category>
		<category><![CDATA[community]]></category>
		<category><![CDATA[content]]></category>
		<category><![CDATA[conversation]]></category>
		<category><![CDATA[forums]]></category>
		<category><![CDATA[pilot]]></category>
		<category><![CDATA[strategy]]></category>

		<guid isPermaLink="false">http://justwriteclick.com/?p=1336</guid>
		<description><![CDATA[While doing some research for LugIron, a startup here in Austin where I serve in an advisory role, I found a slideshow discussing signs of successful community launches by Joe Cothrel, a VP of service at Lithium.
Now, what they mean by &#8220;community&#8221; is a larger than 5,000 person audience, enterprise-type (B2B or B2C focused communities), [...]]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;"><a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fjustwriteclick.com%2F2010%2F01%2F12%2Fpilot-or-not%2F"><img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fjustwriteclick.com%2F2010%2F01%2F12%2Fpilot-or-not%2F" height="61" width="51" /></a></div><p>While doing some research for LugIron, a startup here in Austin where I serve in an advisory role, I found a <a href="http://www.slideshare.net/joecothrel/successful-communities-start-here-lithium-technologies">slideshow discussing signs of successful community launches</a> by Joe Cothrel, a VP of service at Lithium.</p>
<p>Now, what they mean by &#8220;community&#8221; is a larger than 5,000 person audience, enterprise-type (<a href="http://justwriteclick.com/2009/12/22/focused-communities/">B2B or B2C focused communities</a>), and containing primarily forums and blogs (followed by everything else.) So, it&#8217;s not quite the same as the wiki communities that I&#8217;ve studied and participated in. But, what&#8217;s interesting to me is that one of his <strong>Warning signs</strong> on page 8 is a quote from the enterprise:</p>
<blockquote><p>&#8220;We want to do a pilot.&#8221;</p></blockquote>
<p>Huh? Really? Wanting to do a pilot is a warning sign of eminent failure? I guess with blogs and forums, you would want full dedication to the efforts and the goals of the community. But with wiki communities, I think a pilot is a great idea. Pilot content, pilot collaborators, pilot wiki.</p>
<p>What do you think? Do wikis fold up easier than forums? Are pilots getting a bad name in corporate-sponsored communities? Is this a case of the vendor wanting full dedication in their sales engagements?</p>
]]></content:encoded>
			<wfw:commentRss>http://justwriteclick.com/2010/01/12/pilot-or-not/feed/</wfw:commentRss>
		<slash:comments>3</slash:comments>
		</item>
		<item>
		<title>Hone writing skills or specialize?</title>
		<link>http://justwriteclick.com/2009/12/28/written-vs-multimedia/</link>
		<comments>http://justwriteclick.com/2009/12/28/written-vs-multimedia/#comments</comments>
		<pubDate>Mon, 28 Dec 2009 20:57:47 +0000</pubDate>
		<dc:creator>annegentle</dc:creator>
				<category><![CDATA[Featured]]></category>
		<category><![CDATA[social media]]></category>
		<category><![CDATA[community]]></category>
		<category><![CDATA[content]]></category>
		<category><![CDATA[contentstrategy]]></category>
		<category><![CDATA[user-generated content]]></category>
		<category><![CDATA[web]]></category>
		<category><![CDATA[writing]]></category>

		<guid isPermaLink="false">http://justwriteclick.com/?p=1280</guid>
		<description><![CDATA[Never permit a dichotomy to rule your life, a dichotomy in which you hate what you do so you can have pleasure in your spare time. Look for a situation in which your work will give you as much happiness as your spare time.
Pablo Picasso
Someone pointed out a bit of a dichotomy in technical communication [...]]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;"><a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fjustwriteclick.com%2F2009%2F12%2F28%2Fwritten-vs-multimedia%2F"><img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fjustwriteclick.com%2F2009%2F12%2F28%2Fwritten-vs-multimedia%2F" height="61" width="51" /></a></div><blockquote><p>Never permit a dichotomy to rule your life, a dichotomy in which you hate what you do so you can have pleasure in your spare time. Look for a situation in which your work will give you as much happiness as your spare time.<br />
<strong>Pablo Picasso</strong></p></blockquote>
<p><a href="http://justwriteclick.com/blog/wp-content/uploads/2009/12/Pablo_picasso.jpg"><img class="alignleft size-full wp-image-1285" style="margin: 10px;" title="Pablo_picasso" src="http://justwriteclick.com/blog/wp-content/uploads/2009/12/Pablo_picasso.jpg" alt="" width="200" height="247" /></a>Someone pointed out a bit of a dichotomy in technical communication the other day. It was such an interesting observation that I&#8217;ve been thinking about it for a while. The dichotomy is between the power of plain old writing skills and the power of &#8220;sexier&#8221; specialized skills.</p>
<h2>What are the specialties?</h2>
<p>Directions for tech comm that  Tom Johnson and Alan Porter discuss on their respective blogs is a movement towards videos and screencasting (<a href="http://www.idratherbewriting.com/category/screencasts/">screencasts category on Tom&#8217;s blog</a>) or graphics and illustrating (<a href="http://4jsgroup.blogspot.com/search/label/comics">comics category on Alan&#8217;s blog</a>). Mostly the posts talk about how users don&#8217;t read the manual (<a href="http://www.idratherbewriting.com/2009/12/27/if-no-one-reads-the-manual-thats-okay/">which is apparently okay</a>). Perhaps specialization is a wise direction to take, because it&#8217;s a specialty that won&#8217;t be taken over by &#8220;the crowd&#8221; as easily as writing. <a href="http://www.WordPress.tv">WordPress.tv</a>, for example, was seeded with 20 professionally-produced how-to videos, and the community can add videos to the site as well. You can mostly detect which were made by professional film-makers, so it would appear they&#8217;re employable longer.<br />
<object classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000" width="400" height="224" codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=6,0,40,0"><param name="flashvars" value="guid=iN87FFtO&amp;width=400&amp;height=224" /><param name="src" value="http://v.wordpress.com/wp-content/plugins/video/flvplayer.swf?ver=1.11" /><param name="allowfullscreen" value="true" /><embed type="application/x-shockwave-flash" width="400" height="224" src="http://v.wordpress.com/wp-content/plugins/video/flvplayer.swf?ver=1.11" allowfullscreen="true" flashvars="guid=iN87FFtO&amp;width=400&amp;height=224"></embed></object></p>
<h2>Content farms go moo</h2>
<p>Since anyone can write, and <a href="http://www.readwriteweb.com/archives/content_farms_impact.php">content farms</a> are impacting the web, filling it to the brim with quickly written, search-engine baited <a href="http://www.copyblogger.com/fast-food-content/">fast-food content</a>, hone more specialized skills in order to thrive in the shifting sands of the web, right? However, content experts like <a href="http://conversionscientist.com">Brian Massey</a> say that all content, no matter the source, is what&#8217;s driving the successful websites and web applications today. The written word is still effective with measurable results, and is overwhelmingly more prevalent on the web today, page for page. <a href="http://Mint.com">Mint.com</a>, for example, is a wonderful redistributor and aggregator of banking and investment accounts, a specialized type of content. Mint also creates content, such as the weekly summary newsletter, that encourages you to return to the site. This content is text and numbers, with lovely graphs, but it&#8217;s really the numbers that shine.</p>
<h2>To summarize</h2>
<p>With both sides pointed out to me now, I&#8217;m leaning towards the broader content strategy movement. I will help people get content from any source, even if it&#8217;s built by a community or (gasp) ordinary users. But I do see the value in video and especially in non-text-heavy mobile content as we roll into the new year and a new decade.</p>
<p>Here&#8217;s my observation. If it&#8217;s true that <a href="http://bit.ly">bit.ly</a>, the <a href="http://www.wired.com/epicenter/2009/07/twitter-url-service-bitly-says-no-to-ads-yes-to-data-mining-news/">link shortener that&#8217;s popular on social sharing sites, has counted over a billion click-throughs per month</a>, then it&#8217;s possible that social sharing will overtake search engine optimized content. As noted in <a href="http://www.openforum.com/idea-hub/topics/marketing/article/5-trends-that-will-shape-small-business-in-2010-john-jantsch">5 Trends That Will Shape Small Business in 2010</a>, &#8220;Social search has the ability to eclipse the value of traditional SEO efforts.&#8221; A comment counters with the trend to go from text to video, saying clients should &#8220;record, record, and then record some more.&#8221;</p>
<p>Let me repeat that. Eventually there could be more people reading and clicking through links on social sites than searching and clicking through links in search results. How will that shift change how you create content, and how will you strategically choose the content that you create?</p>
]]></content:encoded>
			<wfw:commentRss>http://justwriteclick.com/2009/12/28/written-vs-multimedia/feed/</wfw:commentRss>
		<slash:comments>8</slash:comments>
		</item>
		<item>
		<title>Content strategy and web writing</title>
		<link>http://justwriteclick.com/2009/12/16/content-strategy-and-web-writing/</link>
		<comments>http://justwriteclick.com/2009/12/16/content-strategy-and-web-writing/#comments</comments>
		<pubDate>Wed, 16 Dec 2009 23:02:44 +0000</pubDate>
		<dc:creator>annegentle</dc:creator>
				<category><![CDATA[social media]]></category>
		<category><![CDATA[techpubs]]></category>
		<category><![CDATA[tools]]></category>
		<category><![CDATA[work]]></category>
		<category><![CDATA[writing]]></category>
		<category><![CDATA[content]]></category>
		<category><![CDATA[strategy]]></category>
		<category><![CDATA[web]]></category>

		<guid isPermaLink="false">http://justwriteclick.com/?p=1255</guid>
		<description><![CDATA[Boy, it must be getting harder and harder to be a web writer. I&#8217;m reading Content Strategy for the Web, and the web writer job description is intimidating! The quote that stuck with me talks about the Web Writers Real Job: problem solvers who write well. I do hope this quote describes many technical communicators [...]]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;"><a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fjustwriteclick.com%2F2009%2F12%2F16%2Fcontent-strategy-and-web-writing%2F"><img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fjustwriteclick.com%2F2009%2F12%2F16%2Fcontent-strategy-and-web-writing%2F" height="61" width="51" /></a></div><p><a href="http://www.amazon.com/gp/product/0321620062?ie=UTF8&amp;tag=justwriteclic-20&amp;linkCode=as2&amp;camp=1789&amp;creative=390957&amp;creativeASIN=0321620062"><img class="alignleft size-full wp-image-1269" style="margin: 10px;" title="contentstrategyfortheweb" src="http://justwriteclick.com/blog/wp-content/uploads/2009/12/contentstrategyfortheweb.jpg" alt="contentstrategyfortheweb" width="125" height="160" /></a>Boy, it must be getting harder and harder to be a web writer. I&#8217;m reading <em>Content Strategy for the Web</em>, and the web writer job description is intimidating! The quote that stuck with me talks about the <strong>Web Writers Real Job: problem solvers who write well</strong>. I do hope this quote describes many technical communicators today.</p>
<blockquote><p>&#8220;The web writer&#8217;s mission? Useful, usable content that&#8217;s also enjoyable. It&#8217;s her job to begin a conversation with the reader that results in mutually beneficial outcomes all around. A problem solved. An article found. A connection made.&#8221;</p></blockquote>
<p>All of these outcomes can be tied to thinking about technical documentation as a conversation starter. My <a href="http://justwriteclick.com/book">book </a>talks about social media enabling those conversations. Often, though, social distribution is simply the technique, but the web itself is the medium. When writing in that medium, we must be the best writers with the most considerations taken into account while writing. Search engine optimization. Style and voice when writing for the web versus print. Information architecture, organization, and label naming. Maintaining a content inventory. Auditing and editing content. Testing content. Handling workflow, reviews, and deadlines. The list could go on and on.</p>
<p>And here&#8217;s the thing. People are not backing down from figuring out a great web strategy despite the challenges, and finding great success. I had a great lunchtime conversation with Brian Massey, the <a href="http://conversionscientist.com/">Conversion Scientist</a>. He basically mapped technical publications&#8217; typical goals to the personas that help you encourage a conversion. Fascinating! He describes four personas typically used by marketing writers on the web in the blog post, <a href="http://conversionscientist.com/wordpress/developing-personas/relate-to-four-connect-with-thousands/">Relate to Four, Connect with Thousands</a>:</p>
<p><strong>Methodical </strong>- Probably the first persona to come to mind when talking about traditional technical documentation, perhaps not even all that web-hungry. They want proof, answers, solutions, in an orderly fashion. They&#8217;d probably download and read a PDF file if it&#8217;s offered.</p>
<p><strong>Competitive </strong>- They want information that will make them better, smarter, or cutting-edge. They may be the implementer at a company who will train others in the product you&#8217;re documenting, so they&#8217;d want scenarios that make them look good.</p>
<p><strong>Humanist </strong>- To me, this type of persona, one who looks for relationships and the human element, might be difficult to deliver technical documentation to. They might pick up the phone to call tech support faster than looking up a question online, unless a community is behind the documentation that they can relate to. The humanist may also appreciate case studies that help them relate to a real story.</p>
<p><strong>Spontaneous </strong>- They want to know the answer quickly and move on, so scannable headlines and topic authoring with any topic being a potential entry point will probably work well for them.</p>
<p>I&#8217;m definitely looking at my web writing in new ways. Not just in terms of deliverables, but also in terms of the content I can deliver to the right audiences, to help them meet their goals.</p>
]]></content:encoded>
			<wfw:commentRss>http://justwriteclick.com/2009/12/16/content-strategy-and-web-writing/feed/</wfw:commentRss>
		<slash:comments>6</slash:comments>
		</item>
		<item>
		<title>Casting a wider net for content</title>
		<link>http://justwriteclick.com/2009/12/07/casting-a-wider-net-for-content/</link>
		<comments>http://justwriteclick.com/2009/12/07/casting-a-wider-net-for-content/#comments</comments>
		<pubDate>Mon, 07 Dec 2009 10:51:43 +0000</pubDate>
		<dc:creator>annegentle</dc:creator>
				<category><![CDATA[social media]]></category>
		<category><![CDATA[agile]]></category>
		<category><![CDATA[content]]></category>
		<category><![CDATA[content creation]]></category>
		<category><![CDATA[web content]]></category>
		<category><![CDATA[writing]]></category>

		<guid isPermaLink="false">http://justwriteclick.com/?p=1251</guid>
		<description><![CDATA[I spoke with Rachel Potts, technical communications manager at Red Gate Software this week. They have done an innovative, seamless content combination for their Support Center (red-gate.com/supportcenter) to combine Author-it HTML output with technical support articles. Forums are one click away from those articles, and the authors include both technical writers and customer support pros. [...]]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;"><a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fjustwriteclick.com%2F2009%2F12%2F07%2Fcasting-a-wider-net-for-content%2F"><img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fjustwriteclick.com%2F2009%2F12%2F07%2Fcasting-a-wider-net-for-content%2F" height="61" width="51" /></a></div><p>I spoke with Rachel Potts, technical communications manager at Red Gate Software this week. They have done an innovative, seamless content combination for their Support Center (<a href="http://www.red-gate.com/supportcenter/">red-gate.com/supportcenter</a>) to combine Author-it HTML output with technical support articles. Forums are one click away from those articles, and the authors include both technical writers and customer support pros. As she describes it herself, &#8220;The Red Gate support site is a help and support portal that comprises content such as product help, a knowledge base, marketing videos and public forums.&#8221;</p>
<p><a href="http://justwriteclick.com/blog/wp-content/uploads/2009/12/redgatesupport.jpg"><img class="alignleft size-medium wp-image-1252" style="margin: 10px;" title="redgatesupport" src="http://justwriteclick.com/blog/wp-content/uploads/2009/12/redgatesupport-300x217.jpg" alt="redgatesupport" width="300" height="217" /></a></p>
<p>I&#8217;m impressed and enjoyed speaking with Rachel about how they combined content from different sources. To integrate their output with the customer support articles, massive XML transforms are built against the Author-it output to populate the custom content management system that runs the support website. The content is not locked behind a support login, though.</p>
<p>Rachel has written an extensive article about their use of Google Analytics on the site, titled, <a href="http://communicationcloud.wordpress.com/2009/11/19/what-can-web-analytics-do-for-technical-communications/">What can web analytics do for technical communications?</a> It&#8217;s a great article, one I&#8217;d been hoping for, that describes the useful metrics and what to glean from those data points, such as page views, unique page views, exit rate, and time on page. She also extensively analyzes search data. I also appreciated the section on identifying pages that no one reads. Fortunately, they don&#8217;t have that problem with their content.</p>
<p>She&#8217;s looking for examples of people who are pulling content from multiple authors in different areas in the company and also people outside of the company. Here are the three I sent her.</p>
<ul>
<li><strong>Adobe&#8217;s community help search</strong> is described on this page, and you can link to it to try it from there as well: <a href="http://community.adobe.com/help/about.html">http://community.adobe.com/help/about.html</a>. It&#8217;s described as &#8220;This search index includes content such as product Help, language references, TechNotes, Developer Connection articles, and Design Center tutorials as well as the best online content from the Adobe community. Searchable content is chosen by experts at Adobe and in the design and developer communities, meaning you find the focused answers you need faster than with any standard web search.&#8221;</li>
<li><strong>Sun Microsystems</strong> has projects where technical writers are gathering different types of content. NetBeans Ruby is the project I heard about at the <a href="http://justwriteclick.com/2008/06/05/stc2008-engaging-diverse-audiences-with-screencasts-wikis-and-blogs/">STC Summit in 2008</a>. Here&#8217;s their wiki: <a href="http://wiki.netbeans.org/Ruby">http://wiki.netbeans.org/Ruby</a>. They post screencasts and tutorials to <a href="http://mediacast.sun.com">http://mediacast.sun.com</a>.</li>
<li><strong>Cisco</strong> has done some remodeling on their support community, for the better, by combining more content: <a href="https://supportforums.cisco.com/index.jspa">https://supportforums.cisco.com/index.jspa</a>.</li>
</ul>
<p>I&#8217;m interested in hearing your examples as well as talking to people who have cast a wider net to gather content for support sites. What are your favorite sites, either as a consumer or creator of support information?</p>
]]></content:encoded>
			<wfw:commentRss>http://justwriteclick.com/2009/12/07/casting-a-wider-net-for-content/feed/</wfw:commentRss>
		<slash:comments>2</slash:comments>
		</item>
		<item>
		<title>Collaborative authoring &#8211; tools and costs</title>
		<link>http://justwriteclick.com/2009/11/30/collaborative-authoring/</link>
		<comments>http://justwriteclick.com/2009/11/30/collaborative-authoring/#comments</comments>
		<pubDate>Tue, 01 Dec 2009 02:18:04 +0000</pubDate>
		<dc:creator>annegentle</dc:creator>
				<category><![CDATA[social media]]></category>
		<category><![CDATA[authoring]]></category>
		<category><![CDATA[collaboration]]></category>
		<category><![CDATA[content]]></category>
		<category><![CDATA[content maangement]]></category>
		<category><![CDATA[technical writing]]></category>
		<category><![CDATA[techpubs]]></category>
		<category><![CDATA[writing]]></category>

		<guid isPermaLink="false">http://justwriteclick.com/?p=1236</guid>
		<description><![CDATA[I&#8217;ve been working on some collaborative authoring scenarios for our Agile teams &#8211; we&#8217;re going from 5 people to 47 people in total who could author external or internal documentation within our two week sprints. Turns out, we likely represent some trends in the enterprise &#8211; Forrester just released a report about benchmarking your collaboration [...]]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;"><a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fjustwriteclick.com%2F2009%2F11%2F30%2Fcollaborative-authoring%2F"><img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fjustwriteclick.com%2F2009%2F11%2F30%2Fcollaborative-authoring%2F" height="61" width="51" /></a></div><p>I&#8217;ve been working on some collaborative authoring scenarios for our Agile teams &#8211; we&#8217;re going from 5 people to 47 people in total who could author external or internal documentation within our two week sprints. Turns out, we likely represent some trends in the enterprise &#8211; <a href="http://www.forrester.com/Research/Document/Excerpt/0,7211,48336,00.html">Forrester just released a report about benchmarking your collaboration strategy</a>.  A quote from the abstract does describe our need to broaden our collaboration to more and more people.</p>
<blockquote><p>A companywide collaboration strategy was once a nice-to-have. No more. Even in the current economic climate, 37% of organizations surveyed in Forrester&#8217;s Q4 2008 enterprise and SMB software survey consider implementing a collaboration strategy important in 2009. Two broad trends are driving this: 1) There&#8217;s a critical need to drive information worker efficiency and to manage the unstructured content artifacts they produce; and 2) while the value of improved collaboration is clear, the path to success has become more complex.</p></blockquote>
<p>Also, I&#8217;m finding that we have broader considerations than just the technical publications department for serving up the best content for customers. While researching some solutions, I discovered that most enterprise-level solutions would require a jump from four-figure annual costs (less than 10,000 USD) to five-figure annual costs (greater than 10,000 USD). Or, to go from four-figure costs to four-figure costs while still meeting the author requirements may require an open software solution.</p>
<p>I&#8217;m blogging about it because it seemed like an interesting phenomenon. I don&#8217;t usually like to write about tools, because I don&#8217;t want to seem like I&#8217;m endorsing a vendor. And I&#8217;m not endorsing any vendors, especially with the new <a href="http://www.ftc.gov/opa/2009/10/endortest.shtm">FTC guidelines</a>. But I thought by sharing this on the Internet, I might get some clarity on whether there is a true trend in the field of technical communication towards collaborative authoring environments, and perhaps discover what are the collective forces that are pushing us towards collaborative authoring.</p>
<p>First, some requirements for the system we need.</p>
<h2>Consumer requirements</h2>
<ul>
<li>Must get a known version of the docs that were delivered with a particular software release</li>
<li>Must output printed books &#8211; PDF is fine, previously we used Word .doc files delivered in electronic format however</li>
<li>Must enable draft content to be available internally for review every week (even though we are on two-week sprints, three of six teams are on alternating sprints so once-a-week publishing, really once a day or on demand publishing would be required)</li>
<li>Many other items like syndicated content, comments, ratings, web analytics, but these are not &#8220;must haves&#8221;</li>
</ul>
<h2>Author requirements</h2>
<ul>
<li> Must fit into budget constraints (this amount is four figures currently)</li>
<li>Must meet the existing server and client system requirements (Windows-based, with a SQL Server installation available)</li>
<li>Must be supportable by three tiers: author community of practice, then the members of Agile teams, and then the corporate IT team</li>
<li>Must enable two authors per Agile team minimally (12-14), ideally allowing all 47 members of production teams to create content</li>
<li>Must enable concurrent use by authors in two different versions of the product</li>
</ul>
<h2>Possible collaborative authoring solutions</h2>
<p>This list is not comprehensive, and I&#8217;m sure people would like to jump in with suggestions &#8211; feel free to do so. Remember that I&#8217;m in the &#8220;less than 50 users&#8221; category, and that the goal is company-generated user assistance articles, not community-generated articles. Authoring happens behind the firewall, but the content should be freely available once &#8220;published.&#8221;</p>
<p><strong>Five figures:</strong></p>
<p>Author-it Live: $30,000 (although their website is currently saying there are pricing discounts which make it about $15,000)</p>
<p>Sharepoint 2007 server: $40,000</p>
<p>Author-it to Sharepoint plugin: $25,000</p>
<p>Alfresco (compare to Sharepoint): $20,000 (blog entries hint at the cost)</p>
<p><strong>Four figures:</strong></p>
<p>Confluence: $2200 for 100 users or $800 for 25 users, annual cost (migration could be free depending on what tool you use to migrate content)</p>
<p>MediaWiki: free (migration would require WebWorks ePublisher)</p>
<p>WebWorks ePublisher: Server version $2000/year</p>
<p>Drupal: free (migration could be free depending on the method)</p>
<h2>Migration</h2>
<p>Migration is completely possible, when given the time to do it. We have over 4,000 HTML files on our helpsite currently. Interestingly, DITA could play into the migration scheme because it offers a universal &#8220;translation&#8221; like a Rosetta Stone, giving content some fluidity.</p>
<p>1. DITA2Wiki</p>
<p>This is an open source project that takes DITA output and transforms<br />
it to Confluence Wiki, and it could be automated with builds. Download<br />
it from <a href="http://sourceforge.net/projects/dita2wiki/" target="_blank">http://sourceforge.net/projects/dita2wiki/</a>.</p>
<p>2. WebWorks ePublisher</p>
<p>This is a proprietary software tool that has an annual cost, available at <a href="http://www.webworks.com/">WebWorks.com</a>. I have a free version that I am using and it works, with lots of customization work in the designer we could get nice output, but at a cost. The Express version is $300 a year, but it would not give us the customizations on output that we would need. The Pro version is $800/year, giving us design, but not ongoing builds with the tool. The Server version is $2000/year which gives you designer plus a command line interface that could automatically build wiki output every time the product is built. WebWorks outputs to MediaWiki, Confluence, and MoinMoin. I have only tested output to Confluence, which works great.</p>
<p>3. Confluence DocImporter</p>
<p>This tool, <a href="http://confluence.atlassian.com/display/DOC/Importing+an+Office+Document+into+Confluence">Doc Import</a>, is built into the Confluence wiki itself and offers a manual web-form-based import of Word documents. The pilot work I did worked really well. After we worked on a sidebar table of contents, however, no additional Word docs can be imported due to some setting where it won&#8217;t override existing pages. I would do more work on this method because the results are at first glance even better than those from WebWorks ePublisher. But, this method does not offer automation (unless we find an API that automates using  DocImporter).</p>
<p>4. Drupal&#8217;s HTML Import</p>
<p>This method is as-yet untried for our content, but the idea is that we could take our existing HTML output, which is pretty well-structured, and use the <a href="http://drupal.org/project/import_html">Drupal Import HTML module</a> on the entire site, a section at a time. I think this method would work, although it is more than a bit labor intensive for over 4,000 HTML files and all the links and images involved.</p>
<h2>Topic-oriented, web content</h2>
<p>There are two other options that come to mind when mentioning collaborative authoring. They are Acrobat.com at $390/year and Google Docs, with no price. But those options do not offer a topic-oriented content management system that you could use to output web content &#8211; instead you get bundles of PDFs or Word documents. I&#8217;m not sure either of those are viable for our requirements. But maybe I need to be thinking outside of the box?</p>
<p>What are some of your favorite collaborative authoring tools, and why?</p>
]]></content:encoded>
			<wfw:commentRss>http://justwriteclick.com/2009/11/30/collaborative-authoring/feed/</wfw:commentRss>
		<slash:comments>18</slash:comments>
		</item>
		<item>
		<title>There&#8217;s no crying in Agile!</title>
		<link>http://justwriteclick.com/2009/11/11/theres-no-crying-in-agile/</link>
		<comments>http://justwriteclick.com/2009/11/11/theres-no-crying-in-agile/#comments</comments>
		<pubDate>Wed, 11 Nov 2009 21:12:24 +0000</pubDate>
		<dc:creator>annegentle</dc:creator>
				<category><![CDATA[social media]]></category>
		<category><![CDATA[techpubs]]></category>
		<category><![CDATA[tools]]></category>
		<category><![CDATA[wiki]]></category>
		<category><![CDATA[agile]]></category>
		<category><![CDATA[content]]></category>
		<category><![CDATA[content creation]]></category>
		<category><![CDATA[web content]]></category>
		<category><![CDATA[writing]]></category>

		<guid isPermaLink="false">http://justwriteclick.com/?p=1186</guid>
		<description><![CDATA[I loved the line, as delivered by Tom Hanks in A League of Their Own, &#8220;There&#8217;s no crying in baseball!&#8221; I know there are times when the crying must happen without delay. I don&#8217;t believe most workplaces actively encourage crying &#8211; at least not outside of acting careers.
When I&#8217;ve read Agile practitioner reports that tell [...]]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;"><a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fjustwriteclick.com%2F2009%2F11%2F11%2Ftheres-no-crying-in-agile%2F"><img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fjustwriteclick.com%2F2009%2F11%2F11%2Ftheres-no-crying-in-agile%2F" height="61" width="51" /></a></div><p><a href="http://justwriteclick.com/blog/wp-content/uploads/2009/11/cryinginbaseball.jpg"><img class="alignleft size-medium wp-image-1190" style="margin: 10px;" title="cryinginbaseball" src="http://justwriteclick.com/blog/wp-content/uploads/2009/11/cryinginbaseball-300x193.jpg" alt="cryinginbaseball" width="300" height="193" /></a>I loved the line, as delivered by Tom Hanks in A League of Their Own, &#8220;There&#8217;s no crying in baseball!&#8221; I know there are times when the crying must happen without delay. I don&#8217;t believe most workplaces actively encourage crying &#8211; at least not outside of acting careers.</p>
<p>When I&#8217;ve read Agile practitioner reports that tell tales of times when technical writers have left meetings and fled to cry, I am not just surprised but a little dismayed.In <a href="http://tc.eserver.org/28603.html">A Tale of Two Writing Teams</a> from an Agile conference three years ago, one anonymous writing team reported one writer in particular crying during the daily standup and in retrospectives.</p>
<blockquote><p>As the prioritization changed from the new Java web program (the new and fun stuff) to updating the old, stuffy legacy client server code, writers’ tasks switched from creating new online Help to updating old versions of end-user documentation (books). This change caused the writing team to revert to form—that is, they began to demand written design specs. It’s as if once the technology took a step back from online Help to written documentation because of the prioritization of the product backlog, so did the methodology choice. I tried my best to coach the writers to work creatively with developers on the old stuff as they had on the new, but there was an insistence that the existing specs<br />
for the old legacy code would now become outdated, and the writers were completely uncomfortable with that. One writer—the one with the most tenure—<br />
moved out of the team room, citing lack of privacy and her ability to contribute as the reasons (when I know that it was really a lack of embracing the change). I can remember several episodes of her crying during daily scrum meetings and in<br />
retrospectives.</p></blockquote>
<p>The paper author&#8217;s analysis indicates that the stress of embracing change caused the outburst I think the stress of change can bring on an emotional outburst, and sometimes people have crying as their stress release.</p>
<p>But what is more interesting to me as a content provider is that the change in the tools used to deliver the documentation seemed to correlate to the writer&#8217;s work habits. As I search for wiki solutions for collaborative authoring on Agile teams, I&#8217;m reminded of this article again and again. There&#8217;s no crying in Agile, and having an Agile documentation tool should help with change management. Except, of course, the change management associated with bringing in a wiki. Stewart Mader had great suggestions at the <a href="http://justwriteclick.com/2009/10/20/notes-from-webworks-roundup-2009/">recent WebWorks Roundup</a>: make wiki upkeep part of everyone&#8217;s job, make it as easy as email, and make it as sociable and enjoyable as riding the train to work each day. Any other ideas? I&#8217;d love to hear them.</p>
]]></content:encoded>
			<wfw:commentRss>http://justwriteclick.com/2009/11/11/theres-no-crying-in-agile/feed/</wfw:commentRss>
		<slash:comments>5</slash:comments>
		</item>
		<item>
		<title>Content curation &#8211; a manifesto</title>
		<link>http://justwriteclick.com/2009/10/10/content-curation-a-manifesto/</link>
		<comments>http://justwriteclick.com/2009/10/10/content-curation-a-manifesto/#comments</comments>
		<pubDate>Sat, 10 Oct 2009 19:33:39 +0000</pubDate>
		<dc:creator>annegentle</dc:creator>
				<category><![CDATA[social media]]></category>
		<category><![CDATA[career]]></category>
		<category><![CDATA[career plans]]></category>
		<category><![CDATA[content]]></category>
		<category><![CDATA[content creation]]></category>
		<category><![CDATA[jobs]]></category>
		<category><![CDATA[web content]]></category>
		<category><![CDATA[writing]]></category>

		<guid isPermaLink="false">http://justwriteclick.com/?p=1158</guid>
		<description><![CDATA[The phrase &#8220;content curator&#8221; was one I had to define in the glossary of my book. It seems now that content curator is an idea that others are writing about as well.
RJ Jacquez, Adobe product evangelist, tweeted a link to an article about Content Curation on the site Social Media Today titled &#8220;Manifesto for the [...]]]></description>
			<content:encoded><![CDATA[<div class="tweetmeme_button" style="float: right; margin-left: 10px;"><a href="http://api.tweetmeme.com/share?url=http%3A%2F%2Fjustwriteclick.com%2F2009%2F10%2F10%2Fcontent-curation-a-manifesto%2F"><img src="http://api.tweetmeme.com/imagebutton.gif?url=http%3A%2F%2Fjustwriteclick.com%2F2009%2F10%2F10%2Fcontent-curation-a-manifesto%2F" height="61" width="51" /></a></div><p>The phrase &#8220;content curator&#8221; was one I had to define in the glossary of <a href="http://justwriteclick.com/book/">my book</a>. It seems now that content curator is an idea that others are writing about as well.</p>
<p>RJ Jacquez, Adobe product evangelist, tweeted a link to an <a href="http://socialmediatoday.com/SMC/131472">article about Content Curation on the site Social Media Today</a> titled &#8220;Manifesto for the Content Curator,&#8221; written By Rohit Bhargrava. In it, he describes his definition of a content curator: &#8220;A Content Curator is someone who continually finds, groups, organizes and shares the best and most relevant content on a specific issue online.&#8221;</p>
<p><a href="http://justwriteclick.com/blog/wp-content/uploads/2009/10/manifestoflickr.jpg" target="_blank"><img class="alignleft size-medium wp-image-1159" style="margin: 10px;" title="manifestoflickr" src="http://justwriteclick.com/blog/wp-content/uploads/2009/10/manifestoflickr-300x204.jpg" alt="manifestoflickr" width="300" height="204" /></a>Photo courtesy <a href="http://www.flickr.com/photos/ingorrr/">ingorr on flickr</a></p>
<p>I think that professional writers and technical writers should consider a move towards this role. We already search for and find the best content, sift through loads of content, discard poor content, and publish the most worthy content whenever a software release goes out. This description also sounds like something a content strategist would do as part of their analysis of the content.</p>
<p>What I found fascinating after the article had been out a few days was to read one of the comments, where the commentor seemed to think that tasks related to content curation should be automated. He referenced two sites that curate content by classifying it and rating it, mahalo.com and oneforty.com. He saw content curation as a great opportunity for software developers and entrepreneurs.</p>
<p>What do you think? I&#8217;m guessing my blog&#8217;s audience would protest mightily. Do you believe that content curation can be done by algorithms of rating and relevancy? Or should this job be reserved for specialists?</p>
]]></content:encoded>
			<wfw:commentRss>http://justwriteclick.com/2009/10/10/content-curation-a-manifesto/feed/</wfw:commentRss>
		<slash:comments>9</slash:comments>
		</item>
	</channel>
</rss>
