<?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:media="http://search.yahoo.com/mrss/"
	>

<channel>
	<title>Managing Technical Documentation</title>
	<atom:link href="http://rlhamilton.wordpress.com/feed/" rel="self" type="application/rss+xml" />
	<link>http://rlhamilton.wordpress.com</link>
	<description></description>
	<pubDate>Tue, 10 Jun 2008 22:04:49 +0000</pubDate>
	<generator>http://wordpress.org/?v=MU</generator>
	<language>en</language>
			<item>
		<title>STC 2008: Day Four, June 4</title>
		<link>http://rlhamilton.wordpress.com/2008/06/10/stc-2008-day-four-june-4/</link>
		<comments>http://rlhamilton.wordpress.com/2008/06/10/stc-2008-day-four-june-4/#comments</comments>
		<pubDate>Tue, 10 Jun 2008 22:04:49 +0000</pubDate>
		<dc:creator>rlhamilton</dc:creator>
		
		<category><![CDATA[STC2008]]></category>

		<guid isPermaLink="false">http://rlhamilton.wordpress.com/?p=84</guid>
		<description><![CDATA[After a few days of travel and other diversions, I&#8217;m back home and settling into the old routine.  The last day of STC 2008 flew by pretty quickly.  I saw two talks, plus the closing keynote.  The first talk was Results of a Survey on the Usage and Impacts of Single-Sourcing and [...]]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><p>After a few days of travel and other diversions, I&#8217;m back home and settling into the old routine.  The last day of STC 2008 flew by pretty quickly.  I saw two talks, plus the closing keynote.  The first talk was <em>Results of a Survey on the Usage and Impacts of Single-Sourcing and Content Management, </em>by David Dayton of Towson University.  Dayton&#8217;s objective was to see to what extent people actually realize the benefits of Content Management and Single-Sourcing (CMSS).</p>
<p><span id="more-84"></span></p>
<p>According to Dayton, there is a &#8220;meme&#8221; in Technical Communication literature:</p>
<p>&#8220;XML-enabled CMSS heralds a bright future for those willing to learn—</p>
<ul>
<li>Structured authoring</li>
<li>More collaborative workflows</li>
<li>New tools that break with WYSIWYG to enforce structural rules and use meta-information&#8221;</li>
</ul>
<p>In his view, there is a &#8220;Strong current of technological determinism in the literature on this subject.&#8221;</p>
<p>However, there is very little good data on how widely these technologies are used or what their impact is on those who use them.  His study, supported by STC, attempts to provide a &#8220;cross-sectional statistical view of SS and CM methods and tools.&#8221;  The study, which is still underway, includes a survey of STC members, which is complete, but not completely analysed; interviews and site visits; and a Web 2.0 website to collect first-hand reports.</p>
<p>He will be publishing a full report early next year, but he did discuss some of the results, some of which are very interesting.  Here are some highlights:</p>
<ul>
<li>The majority of IBM DITA users don&#8217;t use a Content Management System, but <em>do</em> single-source; I expected more users at IBM would use a CMS.</li>
<li>About two out of five respondents use single sourcing, but only one in five uses single sourcing with content management.</li>
<li>About one in three uses content management without single sourcing.</li>
<li>Only 1/3 of respondents said that CMSS had made their work group more customer-centered.</li>
<li>18% said that their work group had been involved in an effort to switch to CM or SS that failed;  seems lower than expected.</li>
<li>Adoption appears to be in the &#8220;Early Majority&#8221; phase of the innovation adoption curve; i.e., still well ahead of a tipping point, and he can&#8217;t predict when that point will be reached.</li>
</ul>
<p>I&#8217;m looking forward to his full report; it will be nice to have a more quantitative look at how these technologies work in the real world.</p>
<p>The second regular session I attended was <em>Editing Modular Documentation: Some Best Practices</em> by Michelle Corbin of IBM and Yoel Strimling of Comverse.  This was an excellent presentation; the presenters had a clear sequence, good examples, and clearly stated conclusions.  I went to this presentation because I&#8217;ve rarely had <em>real</em> editors on my staff, so I thought it would be interesting to see some, plus I was curious about what it&#8217;s like editing in a modular methodology.</p>
<p>To me the biggest surprise was the extent to which the presenters&#8217; editing teams got involved with structure.  In fact, it looks like the major value of editors in their environment is to ensure consistent chunking, labeling, and linking; i.e., the three basics of modular documentation.  Issues of writing consistency and style are distinctly secondary, though not ignored.  Given the propensity of organizations to undervalue editing and the tendency for technical communicators to rename roles every few months, I&#8217;m surprised that this particular role, which has evolved considerably from what I&#8217;ve always thought of as editing, hasn&#8217;t been renamed to something glitzier.</p>
<p>Regardless, the talk did give me a new appreciation of this role, and a better understanding of how it can add value in a modular methodology.</p>
<p>The last talk I went to was the closing keynote, by Richard Saul Wurman, who was best known to me as the originator of the Access travel guides.  This was a relaxed, informal talk that almost went off the rails a couple of times, but kept me engaged.  Wurman has a strong pragmatic streak and is someone who is able to get to the heart of an issue.  His current focus is on a project called 192021 (<a title="http://192021.org" href="http://192021.org" target="_blank">http://192012.org</a>), which looks at 19 cities in the world with over 20 million in population in the 21st century.</p>
<p>In his view, the &#8220;rise of supercities is the megatrend of the 21st century.&#8221;  As of last year, more than half of the world&#8217;s population lives in cities, and by 2050, 2/3 of the world&#8217;s population will live in cities.  192021 is a five-year comparative study of these cities, looking at things like health, education, demographics, infrastructure, and culture.  By using a consistent methodology, it will be possible to compare various aspects of these population centers and track trends.  Like his other projects, 192021 strives to make complex information consistent and understandable, and sounds like it will be a worthy project.</p>
<p>While I would have liked to see a little more about how he thinks and how he approaches a topic, I thought the talk was a nice cap to the program and left me with a lot to think about.</p>
<img alt="" border="0" src="http://feeds.wordpress.com/1.0/categories/rlhamilton.wordpress.com/84/" /> <img alt="" border="0" src="http://feeds.wordpress.com/1.0/tags/rlhamilton.wordpress.com/84/" /> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/rlhamilton.wordpress.com/84/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/rlhamilton.wordpress.com/84/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/rlhamilton.wordpress.com/84/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/rlhamilton.wordpress.com/84/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/rlhamilton.wordpress.com/84/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/rlhamilton.wordpress.com/84/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/rlhamilton.wordpress.com/84/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/rlhamilton.wordpress.com/84/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/rlhamilton.wordpress.com/84/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/rlhamilton.wordpress.com/84/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=rlhamilton.wordpress.com&blog=675222&post=84&subd=rlhamilton&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://rlhamilton.wordpress.com/2008/06/10/stc-2008-day-four-june-4/feed/</wfw:commentRss>
	
		<media:content url="http://a.wordpress.com/avatar/rlhamilton-128.jpg" medium="image">
			<media:title type="html">rlhamilton</media:title>
		</media:content>
	</item>
		<item>
		<title>STC 2008: Day Three, June 3</title>
		<link>http://rlhamilton.wordpress.com/2008/06/03/stc-2008-day-three-june-3/</link>
		<comments>http://rlhamilton.wordpress.com/2008/06/03/stc-2008-day-three-june-3/#comments</comments>
		<pubDate>Wed, 04 Jun 2008 04:48:29 +0000</pubDate>
		<dc:creator>rlhamilton</dc:creator>
		
		<category><![CDATA[STC2008]]></category>

		<guid isPermaLink="false">http://rlhamilton.wordpress.com/?p=83</guid>
		<description><![CDATA[Today for me was mostly split between two types of events, talks about Agile development techniques, in particular Scrum, and two &#8220;progressions.&#8221;  To take the latter first, progressions were a new concept to me.  A progression is held in a room with several large tables, each of which has a moderator with a [...]]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><p>Today for me was mostly split between two types of events, talks about Agile development techniques, in particular Scrum, and two &#8220;progressions.&#8221;  To take the latter first, progressions were a new concept to me.  A progression is held in a room with several large tables, each of which has a moderator with a particular topic.  Over the course of a one to two hour progression, participants cycle through 1-4 tables, and have a short conversation with the moderator and other participants.  It&#8217;s a bit like the conference version of &#8220;speed dating,&#8221; without the fear of rejection.</p>
<p><span id="more-83"></span></p>
<p>I ended up at three tables over two progressions, covering topics from <em>Marketing yourself as an independent consultant,</em> to <em>Managing in-country translation reviews, </em>to <em>Managing Virtual Teams. </em>I found the progressions a good way to network with experienced pros, though there was less prepared material than I expected.  Still, I made some good contacts and got some good ideas.</p>
<p>The two Scrum talks, <em>Scrum: An Agile Approach to Managing Content Projects</em>, by Julie MacAller of Microsoft, and <em>Agile Development: Challenges in Transforming TechComm Departments,</em> by Mike Wethington of Troux Technology, provided a nice overview of Scrum.  There&#8217;s no space here for (nor are you likely to have the patience for) a full description of Agile methodologies or Scrum, but here is my best understanding of the Cliff Notes version based on a grand total of two hours of talks.  Skip ahead if you&#8217;re familiar with Scrum.</p>
<p>The base of the methodology is the <em>Roadmap</em>, which is a high level, long term, multi-release plan; the sample Mike Wethington showed was just one page.  Releases are implemented through a series of <em>Sprints</em>, each of which is a 2-4 week cycle.  The planning process generates a <em>backlog</em>, which is the list of all the work being done on the project.  The granularity is such that any writer will implement around 10-12 backlog items over the course of a 2 week sprint.</p>
<p>There is an initial planning session for each sprint that selects the backlog items that will be implemented during that sprint.  The items may be design, implementation, documentation, or testing; in short, if it&#8217;s not on the backlog, it doesn&#8217;t exist.  Over the course of the sprint, the full team meets every day for a short (15 minute max) meeting (called a scrum) to discuss: 1) what was accomplished in the last day, 2) what&#8217;s next, and 3) what&#8217;s standing in the way.  When the team gets big, these meetings may be split, with a representative from each scrum attending another (still only 15 minute) scrum with other representatives.</p>
<p>Sprints continue until the release is complete.</p>
<p>The basic idea is to build a visible, inspected, and adaptable process.  Key to making the process work is quick turnaround and resolution of issues, plus open communication among all committed parties.</p>
<p>Unlike some methodologies, Scrum gives documentation a full seat at the table.  In Scrum terminology, there are Pigs and Chickens, as in &#8220;when you make ham and eggs, chickens are interested, but pigs are committed.&#8221;  The committed (pigs) are the core of the team and are all central players.  Technical communicators are considered pigs, along with developers and QA (quality assurance).</p>
<p>Some of the keys to making scrum work, according to Julie and Mike, are:</p>
<ul>
<li>Make sprint goals customer focused, grouping detailed topics into customer &#8220;stories&#8221;</li>
<li>Pick the right moment to start writing.  There&#8217;s a tendency to get started too early, which can be a real problem with a fluid process.</li>
<li>Get <em>every</em> work item on the backlog, including reviews and SME interviews.</li>
<li>Keep processes lightweight; since you report status daily, formal tracking can be lightweight.</li>
<li>Make sure daily scrum meetings are with development, and not separate.</li>
</ul>
<p>Overall, I found scrum to be an intriguing methodology.  I&#8217;ve managed writers who have used earlier incarnations of Agile methodologies, including spiral development, which is similar, but with longer cycles (more on the order of 6 months), but this is the first time I saw this kind of methodology as offering a significantly better way of doing things.</p>
<p>One final note.  The second talk, by Mike Wethington, resembled a scrum.  There were constant questions, and the talk evolved based on the questions.  In a sense, each slide was a sprint, with frequent questions and discussion.  I think this was not by design, though Mike was receptive to questions.  Rather, it was just a result of participation by several folks who resonated with the ideas, and were assertive.  In fact, I wonder whether a side benefit of this methodology is to encourage more assertive behavior on the part of technical communicators.</p>
<p>The one talk that didn&#8217;t fall into these categories was <em>Creating Task-based Navigation with DITA</em>, with Mike Priestley of IBM and Amber Swope of Just Systems.  They gave a good combination talk/demo on creating task-based navigation using an application called Task Modeler, which is beta software available from IBM.  This application uses a GUI to let you build a DITA application, including the ditamap, relationship tables, and topic groups.  It was nice to see these two skillful presenters put together a nicely integrated and interactive presentation.</p>
<p>My only reservation was a claim that DITA is &#8220;ridiculously cheaper&#8221; to customize than a custom schema.  One company (Nokia) found that changes took 50% less time for DITA, and would have been even better if you didn&#8217;t count the planning time.  While I&#8217;m sure the difference is significant between DITA and a custom schema, the comparison I&#8217;d like to see is DITA vs. DocBook.  I would not expect to see nearly the difference.  However, this demo did show that the tool support for DITA is improving quickly; the Task Modeler is a very nice application that I expect will become very popular.</p>
<p>That&#8217;s all for now.</p>
<img alt="" border="0" src="http://feeds.wordpress.com/1.0/categories/rlhamilton.wordpress.com/83/" /> <img alt="" border="0" src="http://feeds.wordpress.com/1.0/tags/rlhamilton.wordpress.com/83/" /> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/rlhamilton.wordpress.com/83/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/rlhamilton.wordpress.com/83/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/rlhamilton.wordpress.com/83/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/rlhamilton.wordpress.com/83/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/rlhamilton.wordpress.com/83/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/rlhamilton.wordpress.com/83/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/rlhamilton.wordpress.com/83/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/rlhamilton.wordpress.com/83/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/rlhamilton.wordpress.com/83/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/rlhamilton.wordpress.com/83/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=rlhamilton.wordpress.com&blog=675222&post=83&subd=rlhamilton&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://rlhamilton.wordpress.com/2008/06/03/stc-2008-day-three-june-3/feed/</wfw:commentRss>
	
		<media:content url="http://a.wordpress.com/avatar/rlhamilton-128.jpg" medium="image">
			<media:title type="html">rlhamilton</media:title>
		</media:content>
	</item>
		<item>
		<title>STC 2008: Day Two, June 2</title>
		<link>http://rlhamilton.wordpress.com/2008/06/02/stc-2008-day-two-june-2/</link>
		<comments>http://rlhamilton.wordpress.com/2008/06/02/stc-2008-day-two-june-2/#comments</comments>
		<pubDate>Tue, 03 Jun 2008 04:10:02 +0000</pubDate>
		<dc:creator>rlhamilton</dc:creator>
		
		<category><![CDATA[STC2008]]></category>

		<guid isPermaLink="false">http://rlhamilton.wordpress.com/?p=82</guid>
		<description><![CDATA[Three out of four ain&#8217;t bad, and the fourth wasn&#8217;t awful, just not excellent.  Rather that drag you through all four sessions, I&#8217;ll summarize the highlights from the three I got the most from.

The opening Keynote speaker was Howard Rheingold, who gave an interesting talk that centered on the way mobile communication (texting, cell [...]]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><p>Three out of four ain&#8217;t bad, and the fourth wasn&#8217;t awful, just not excellent.  Rather that drag you through all four sessions, I&#8217;ll summarize the highlights from the three I got the most from.</p>
<p><span id="more-82"></span></p>
<p>The opening Keynote speaker was Howard Rheingold, who gave an interesting talk that centered on the way mobile communication (texting, cell phones, etc.) is changing human interaction.  In addition to being an interesting speech, I found his use of graphics compelling.  Instead of the usual bullet points that echo what the speaker is saying, he used graphics that reinforced his points, along with a video sequence, which was nicely synchronized with the speech despite some minor technical problems.</p>
<p>In the afternoon, I attended two panel discussions, the first was titled <em>Content Management Systems Why Can&#8217;t I just Pick One.</em> Participants included Steve Manning of the Rockley Group, Rahel Bailie of Intentional Systems, Nancy Kotkin of Independence Blue Cross, and the moderator, Alan Houser of Group Wellesley.</p>
<p>They spent some time talking about different kinds of Content Management Systems, including Document Management Systems, which primarily store completed documents; Web Content Management Systems, which support web sites; Component Content Management Systems, which support authoring of components.  The latter was until recently a niche market that didn&#8217;t even have an industry standard name.</p>
<p>The rub for technical communicators is that IT departments typically think of the &#8220;big gun&#8221; Document or Web Content Management Systems when they think about CMS&#8217;s.  This leads the IT folks to think they&#8217;ve solved the content management problem, even though these two types of CMS&#8217;s typically are not set up for editing, storage, and retrieval of components.</p>
<p>Alan then asked the participants some questions, starting with, &#8220;How do you assess a customer&#8217;s needs?&#8221;  He further honed this to, &#8220;what&#8217;s your first question&#8221;?  The clearest answer to that came from Steve, who asks, &#8220;what&#8217;s the problem you&#8217;re trying to solve?&#8221;  As I heard at DocTrain, and have heard elsewhere this week, customers typically put the cart before the horse here, asking questions like, &#8220;what&#8217;s the best CMS?&#8221; before they even have the slightest idea what they&#8217;re trying to do.  Steve estimated that as many as two out of five CMS projects fail, for exactly this reason, though he hastened to add that his company&#8217;s failure rate is &#8220;nil.&#8221;</p>
<p>The next question came from an audience member, who asked about granularity.  This caused a fair amount of discussion, with a couple of interesting points:  Nancy commented that she&#8217;s seen projects hit serious problems because they could not agree on the degree of granularity needed.  She also said that she&#8217;s found that technical writers have an easier time working with fine-grained structures than training developers.  The latter tend to see their output as more of a narrative than the former.</p>
<p>Most of the remaining discussion centered around what you should do if your company is starting the search for a CMS, or in a worse case, has already chosen a CMS.  Consensus was that you must get involved with the acquisition and help make sure a sound business decision  is made.  Since IT departments have different needs from technical communication, it&#8217;s important to be part of the decision as early as possible.  If you get in after a decision gets made, you need to do the same analysis, then see how well the chosen system meets your needs.</p>
<p>Bottom line all around is to look at the problem you&#8217;re solving, evaluate needs, and make sure you&#8217;re part of the decision making team when/if a CMS selection is occurring.</p>
<p>The second panel was <em>Evangelizing, Proselytizing, and Preaching: Strategies for Marketing Yourself and Your Expertice to Others.</em> The moderator was Scott Abel, with panelists Ann Rockley, Rahel Bailie, Chris Hester, and Tom Johnson.  Scott ran a tight, well organized panel.  He began by asking each panelist for a favorite marketing tactic.  Chris and Tom, who are employees, both suggested &#8220;inserting&#8221; yourself into meetings and taking the user&#8217;s perspective in those meetings.</p>
<p>Ann and Rahel, who are independent consultants, suggested being active with STC and to share knowledge.  Early in her career, Ann was a member of STC and an active networker.  When she was laid off from her job, she was quickly able to find contracting employment because of her contacts.  Now, she doesn&#8217;t do &#8220;traditional&#8221; marketing.  She continues to share information, attend conferences, and network.  She has been able to build a strong reputation through those means.</p>
<p>Rahel is a prolific writer who uses blog and forum posts, conference attendance, and her web site as outreach.  However, she doesn&#8217;t see the web site as an ad.  Instead, she sees it as providing information that can give prospective customers a taste of what she does and how she does it.  Someone looking at her site can get a good idea of whether her company will be a good fit for their needs.</p>
<p>Other good suggestions for &#8220;self&#8221; marketing, both inside and outside you company, included:</p>
<ul>
<li>Make sure the engineers you work with understand what you do and what value you add.</li>
<li>Blog internally and use other internal communication vehicles to establish your credentials as a communicator and user advocate.</li>
<li>Chris regularly meets with senior staff and shows them the work her team is doing.  She also has one-on-one meetings with senior staff where her objective is to make sure she 1) understands their needs and 2) is meeting them.</li>
<li>Tom has had great success with podcasting, and commented that there are very few technical communicators doing podcasts.  There&#8217;s an opportunity to establish a niche using podcasting, and few people are taking advantage of that opportunity. (I&#8217;ll be starting my podcast shortly <img src='http://s.wordpress.com/wp-includes/images/smilies/icon_smile.gif' alt=':)' class='wp-smiley' /> </li>
</ul>
<p>While these communication techniques are powerful, each of the panelists conceded that you need to prioritize your efforts; doing everything they suggest would leave no time for &#8220;real work.&#8221;  Ann tends to limit blogging, using twitter, etc. She also drops &#8220;optional&#8221; activities she doesn&#8217;t enjoy. Rahel has stopped detailed filing of information (she keeps material unfiled; she finds that locating material when she infrequently needs it takes less time that filing it carefully).  Chris compartmentalizes and batches activity (TIVO helps).  Tom doesn&#8217;t consider most of this to be work; he clearly enjoys the podcasting and other &#8220;marketing&#8221; activities.</p>
<p>The final question was how they put together their &#8220;elevator&#8221; pitch.  The conclusion was that it takes time, practice, lots of metaphors, more time, and more practice.  No one found this easy, though all found it essential.</p>
<p>That&#8217;s all for now.  Another good day, though with all the available activities, it&#8217;s easy to feel like you&#8217;re missing something important, regardless of how valuable the sessions you attend turn out to be.</p>
<img alt="" border="0" src="http://feeds.wordpress.com/1.0/categories/rlhamilton.wordpress.com/82/" /> <img alt="" border="0" src="http://feeds.wordpress.com/1.0/tags/rlhamilton.wordpress.com/82/" /> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/rlhamilton.wordpress.com/82/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/rlhamilton.wordpress.com/82/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/rlhamilton.wordpress.com/82/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/rlhamilton.wordpress.com/82/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/rlhamilton.wordpress.com/82/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/rlhamilton.wordpress.com/82/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/rlhamilton.wordpress.com/82/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/rlhamilton.wordpress.com/82/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/rlhamilton.wordpress.com/82/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/rlhamilton.wordpress.com/82/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=rlhamilton.wordpress.com&blog=675222&post=82&subd=rlhamilton&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://rlhamilton.wordpress.com/2008/06/02/stc-2008-day-two-june-2/feed/</wfw:commentRss>
	
		<media:content url="http://a.wordpress.com/avatar/rlhamilton-128.jpg" medium="image">
			<media:title type="html">rlhamilton</media:title>
		</media:content>
	</item>
		<item>
		<title>STC 2008: Day One, June 1</title>
		<link>http://rlhamilton.wordpress.com/2008/06/01/stc-2008-day-one-june-1/</link>
		<comments>http://rlhamilton.wordpress.com/2008/06/01/stc-2008-day-one-june-1/#comments</comments>
		<pubDate>Mon, 02 Jun 2008 03:56:50 +0000</pubDate>
		<dc:creator>rlhamilton</dc:creator>
		
		<category><![CDATA[STC2008]]></category>

		<guid isPermaLink="false">http://rlhamilton.wordpress.com/?p=81</guid>
		<description><![CDATA[I&#8217;m at the STC 2008 conference this week and will be posting my comments here each day.  This is my first STC conference, and so far I&#8217;m impressed.   Registration was smooth, in part because our badges were mailed in advance.  We just needed to pick up the obligatory tote bag, badge [...]]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><p>I&#8217;m at the STC 2008 conference this week and will be posting my comments here each day.  This is my first STC conference, and so far I&#8217;m impressed.   Registration was smooth, in part because our badges were mailed in advance.  We just needed to pick up the obligatory tote bag, badge holder, program, and marketing material from the sponsors.</p>
<p>I was pleased and surprised that there was a session right off the bat; a panel titled, <em>Is What You&#8217;re Doing Today Enough to Remain Competitive Tomorrow? </em>The panelists were Jack Molisani, Andrea Ames, Bogo Vatovec, and Barbara Giammona (I think that is her name, she was a replacement for Bill See, who was not there), with moderator Paula Berger.</p>
<p>The panel turned out to be a lively crowd that enjoyed mixing it up.  They started off with a few random thoughts before getting up a head of steam.  Among the random comments, I particularly liked Andrea&#8217;s four word slogan, <em>Think More, Write Less.</em> Not only would that make a great book title, it also captures the essence of the panel&#8217;s discussion.</p>
<p>The issue the group settled in on was how to avoid being &#8220;commoditized.&#8221;  A commodity product is one where the only real differentiation is in the pricing.  If you are &#8220;just&#8221; a technical writer, you run the risk of becoming a commodity that can be easily replaced with a lower price alternative.  Andrea, with the concurrence of the rest of the panel, suggested that technical communicators should be asking <em>why</em> instead of <em>what</em>, and should be thinking in terms of solving business problems, rather than documenting products.</p>
<p>She then asked how many people were involved with deciding what their deliverables would be.  She was surprised (and I was shocked) at how few people had a hand in deliverable design or even input into the process.  As a quick digression, I consider deliverable design to be a core technical communication task, and I&#8217;m surprised at how many folks indicated they are in a situation where their deliverables are dictated to them.</p>
<p>The moderator then asked each participant to recommend courses/training that could help communicators avoid becoming a &#8220;commodity.&#8221;  Here are their responses:</p>
<p>Molisani: He recommends Toastmasters, and suggested improving domain knowledge.</p>
<p>Giammona: She recommended project management training.  She told a story about Morgan Stanley, her previous employer.  Within the centralized doc group, there was a group of people who expanded their communications skills and found jobs in other areas, and another group of people who stayed as pure technical writers.  As Morgan went through a series of re-organizations and downsizing, the people in the first group kept their jobs, but those in the second didn&#8217;t.</p>
<p>Vatovec: He suggested learning Project Management skills, Information Architecture, and Object Oriented methodologies; anything <em>but</em> pure technical writing.</p>
<p>Andrea: She suggested learning about DITA, but focusing on the methodology behind it, rather than just the markup.  She also suggested honing negotiating and influencing skills.</p>
<p>At this point, someone commented that the consensus recommendation seemed to be to get <em>out</em> of technical writing.</p>
<p>The best response to this came, I think, from Andrea, who said that writers shouldn&#8217;t change their careers, but rather should change the way they think about their careers.  Jack added that you should think along the lines for being Technical Writer/something else (information architect, interface designer, etc) rather than simply &#8220;Technical Writer.&#8221;</p>
<p>Beyond the obvious point that broader skills will make you more employable, it&#8217;s also the case, fair or unfair, that &#8220;Technical Writer&#8221; as a job category has less value in the marketplace than other skills.</p>
<p>They wrapped things up with two discussions; first about off-shoring.  Beyond the usual questions of reducing costs, Bogo made the important point that some off-shoring is necessary because the market for products has expanded well beyond the U.S. and companies need to go where market knowledge is, regardless of the location.</p>
<p>The final point that I found interesting was a point Bogo made about task oriented writing.  He decried documentation that described how to do isolated, and often trivial, tasks without context.  The interface should make it obvious how to do simple tasks, like printing, without additional documentation.  Where the technical communicator can add value is through context and a deeper understanding of how to solve problems.</p>
<p>Overall, a wide ranging, sometimes disjoint, but thought-provoking panel that I think got things off to a good start.</p>
<img alt="" border="0" src="http://feeds.wordpress.com/1.0/categories/rlhamilton.wordpress.com/81/" /> <img alt="" border="0" src="http://feeds.wordpress.com/1.0/tags/rlhamilton.wordpress.com/81/" /> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/rlhamilton.wordpress.com/81/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/rlhamilton.wordpress.com/81/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/rlhamilton.wordpress.com/81/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/rlhamilton.wordpress.com/81/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/rlhamilton.wordpress.com/81/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/rlhamilton.wordpress.com/81/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/rlhamilton.wordpress.com/81/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/rlhamilton.wordpress.com/81/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/rlhamilton.wordpress.com/81/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/rlhamilton.wordpress.com/81/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=rlhamilton.wordpress.com&blog=675222&post=81&subd=rlhamilton&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://rlhamilton.wordpress.com/2008/06/01/stc-2008-day-one-june-1/feed/</wfw:commentRss>
	
		<media:content url="http://a.wordpress.com/avatar/rlhamilton-128.jpg" medium="image">
			<media:title type="html">rlhamilton</media:title>
		</media:content>
	</item>
		<item>
		<title>What Can We Learn About Motivation from a Tornado?</title>
		<link>http://rlhamilton.wordpress.com/2008/05/28/what-can-we-learn-about-motivation-from-a-tornado/</link>
		<comments>http://rlhamilton.wordpress.com/2008/05/28/what-can-we-learn-about-motivation-from-a-tornado/#comments</comments>
		<pubDate>Wed, 28 May 2008 17:02:58 +0000</pubDate>
		<dc:creator>rlhamilton</dc:creator>
		
		<category><![CDATA[Commentary]]></category>

		<guid isPermaLink="false">http://rlhamilton.wordpress.com/?p=80</guid>
		<description><![CDATA[I spent the last four days scheduling volunteers for an organization supporting the disaster relief after last week&#8217;s tornado in Colorado. When I came home each evening, I would find another installment of a lively discussion about motivation on the mailing list for the Society for Technical Communication&#8217;s (STC) Management Special Interest Group (SIG). It [...]]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><p>I spent the last four days scheduling volunteers for an organization supporting the disaster relief after last week&#8217;s tornado in Colorado. When I came home each evening, I would find another installment of a lively discussion about motivation on the mailing list for the Society for Technical Communication&#8217;s (STC) Management Special Interest Group (SIG). It wasn&#8217;t until the fourth day that I realized that my “<span class="quote">day job</span>” as a volunteer was also a lesson on motivation.</p>
<p>So, what did I learn?</p>
<ul type="disc">
<li>For the right cause, people will do pretty much anything.
<p>For example, I found out at 6pm on Friday night that I needed to assemble a crew of 10 to unload a supply truck at 5am the next morning. Hard work at an insane hour, but I got commitments from everyone I needed within 3 hours. And, for every activity I needed to schedule, we had more volunteers than we needed. This response didn&#8217;t happen because I have some magical skill as a motivator; it happened because the need was critical.</p>
<p>Most business objectives are not as clearly “<span class="quote">right</span>” as feeding disaster victims, but if your objectives make sense, are clearly communicated, and can be seen as productive for the organization, you&#8217;ve got a much better chance of having motivated people.</li>
<li>A strong group helps keep people motivated.
<p>Nearly everyone who volunteered came as part of a group, and not just groups like Red Cross and Salvation Army that exist specifically for disaster relief. Churches and other community groups were a big part of the effort. While there were a few stalwart folks who volunteered independently, they were in the minority. The reason is pretty clear; if you&#8217;re a member of a strong group, you have a motive to serve the group as well as a motive to serve the group&#8217;s objectives. The two reinforce each other.</p>
<p>Given today&#8217;s highly outsourced, geographically diverse projects, most of which operate in an environment where downsizing is the flavor of the decade, it&#8217;s difficult to build a strong team, but if you can pull it off, it becomes really difficult for team members to remain unmotivated. They either get with the program or leave.</li>
</ul>
<p>All of that said, motivation is internal. You can identify clear objectives, communicate them vigorously, create a strong team, and build a supportive environment, but <span class="emphasis"><em>they</em></span> have to drink the Kool Aid, you can&#8217;t do it for them.</p>
<p>I believe that most people will be motivated if you do these things, but some won&#8217;t; they may be in the wrong place, be going through problems outside of work, or simply be one of those folks who never gets motivated by anything. When that happens, you can coerce them and get some results, but almost always the best thing you can do is find them a better job fit or get them out of the environment.</p>
<img alt="" border="0" src="http://feeds.wordpress.com/1.0/categories/rlhamilton.wordpress.com/80/" /> <img alt="" border="0" src="http://feeds.wordpress.com/1.0/tags/rlhamilton.wordpress.com/80/" /> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/rlhamilton.wordpress.com/80/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/rlhamilton.wordpress.com/80/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/rlhamilton.wordpress.com/80/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/rlhamilton.wordpress.com/80/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/rlhamilton.wordpress.com/80/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/rlhamilton.wordpress.com/80/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/rlhamilton.wordpress.com/80/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/rlhamilton.wordpress.com/80/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/rlhamilton.wordpress.com/80/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/rlhamilton.wordpress.com/80/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=rlhamilton.wordpress.com&blog=675222&post=80&subd=rlhamilton&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://rlhamilton.wordpress.com/2008/05/28/what-can-we-learn-about-motivation-from-a-tornado/feed/</wfw:commentRss>
	
		<media:content url="http://a.wordpress.com/avatar/rlhamilton-128.jpg" medium="image">
			<media:title type="html">rlhamilton</media:title>
		</media:content>
	</item>
		<item>
		<title>Day 3: DocTrain Conference</title>
		<link>http://rlhamilton.wordpress.com/2008/05/09/day-3-doctrain-conference/</link>
		<comments>http://rlhamilton.wordpress.com/2008/05/09/day-3-doctrain-conference/#comments</comments>
		<pubDate>Fri, 09 May 2008 06:17:23 +0000</pubDate>
		<dc:creator>rlhamilton</dc:creator>
		
		<category><![CDATA[DocTrain]]></category>

		<guid isPermaLink="false">http://rlhamilton.wordpress.com/?p=79</guid>
		<description><![CDATA[Today was the last &#8220;official&#8221; day of the conference.  Tomorrow (Friday) is a post-conference day of workshops.  Unfortunately, I need to leave early Friday, so I&#8217;ll miss the workshops.
Today started with 3 keynote talks.  The first was from Joshua Duhl of Quark and titled, Once Content is in XML, Now What? He [...]]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><p>Today was the last &#8220;official&#8221; day of the conference.  Tomorrow (Friday) is a post-conference day of workshops.  Unfortunately, I need to leave early Friday, so I&#8217;ll miss the workshops.</p>
<p>Today started with 3 keynote talks.  The first was from Joshua Duhl of Quark and titled, <em>Once Content is in XML, Now What?</em> He introduced the idea of dynamic publishing.  While the talk was mostly a pitch for Quark, it was interesting because Quark is not normally thought of as an XML company.  I think it&#8217;s encouraging that companies that have mostly been in other parts of the technical documentation world are seriously working with XML.</p>
<p>The second keynote was <em>Document Engineering in User Experience Design</em>, by Robert Glushko of the University of California, Berkeley.  Bob has a new book titled, <em><span class="asinTitle"><span>Document Engineering: Analyzing and Designing Documents for Business Informatics and Web Services.</span></span></em></p>
<p>He spoke about the idea of Document Engineering as a methodology that is a synthesis of information and system analysis, and business process engineering.  In an e-commerce environment, customer satisfaction is more than the User Interface.  We tend to think of the customer experience as being a &#8220;front stage&#8221; function; that is, the immediately visible parts of a system.  But, in fact, the &#8220;back stage&#8221; functions, the plumbing that makes everything happen matters as much to customer satisfaction.</p>
<p>Glushko says that we need designs that cut across back and front stage operations.  He described the &#8220;Moment of Truth,&#8221; which is the point where a problem or other critical event becomes clear to the customer.  Moments of Truth are often the intrusion of a back stage problem (supply chain problems or other failures in plumbing) onto the front stage.  The design needs to encompass both the front and back stage to be fully successful.</p>
<p>The third keynote was <em>Social Media 101, </em>presented by Darren Barefoot of Capulet Communications.  Darren was probably the most skillful presenter I saw this week in the use of presentation materials.  He used very few words; large portions of the talk were accompanied by pictures that alluded to what he was discussing, but rarely, if ever, repeated what he was saying.</p>
<p>He discussed characteristics of social media, which include conversation, collaboration, sharing, broadening of scope, community, transparency, and authenticity.  To me the critical point is that all manner of web communications have become multi-way.  There are few areas where a pure, one way broadcast of information makes sense.  For example, users are now part of the product support cycle, having input into every part of the support cycle.</p>
<p>The second critical message is that resistance is not only futile, it&#8217;s counterproductive.  Companies will gain more by giving up some control and taking full advantage of social media.  This means empowering your most passionate users, giving users the tools they need to help each other, and going to the places your users go.  If they use youtube, you need to be there; if they use twitter, go there.</p>
<p>The first regular session of the day I attended was <em>DocBook vs DITA: Will the Real Standard Please Stand Up</em>, presented by Teresa Mulvihill.  Since I&#8217;m on the DocBook TC, I was particularly interested in this talk.  In general, I think Mulvihill&#8217;s views are close to mine (see my article titled, <a href="http://www.thecontentwrangler.com/article/choosing_an_xml_schema_docbook_or_dita/">Choosing an XML Schema: DocBook or DITA</a>).  However, as someone who has worked with customers on both DocBook and DITA, she sees more difference between the two tool chains than I&#8217;ve seen (I&#8217;ve done extensive work with DocBook, but much less with DITA, so I don&#8217;t have her perspective).  She strongly favors DocBook in smaller, turnkey environments; a sentiment I share, though possibly not as strongly.</p>
<p>We were fortunate to have people who use both DocBook and DITA in the audience and had a good discussion after the formal talk.</p>
<p>The next talk was a short talk by David Ashton, of SDL (the company that offers the TRADOS translation support tool), titled <em>24 Ways to Shut Down the Application and other Apocryphal Stories</em>.  He gave a nice high level introduction to some of the trials and tribulations of translation, tying it into the publication process.</p>
<p>I then snuck into the second half of Joe Gollner&#8217;s last talk of the conference, <em>Extreme Content Makeover: Migrating Content to DITA.</em> While the talk focused on DITA, the basic principles would apply to any data conversion.  In addition to the expected exhortations to plan carefully, Joe covered some less obvious, but important points, including:</p>
<ul>
<li>Establish Control Collections, which means to look for groupings of files that have similar features, and therefore are likely to need the same kinds of conversions.</li>
<li>Define the target end state, which goes beyond simply selecting a target schema; that&#8217;s just the bare minimum.  You also need to consider linking, metadata, and other details of the target.</li>
<li>Prepare a conversion specification, which defines the end state, naming conventions, mappings, and so forth.</li>
<li>Establish a representative example set, which is a group of files that cover the range of the control collections and gives you a set of content for testing.</li>
<li>Build a conversion plan, which is a project plan for the conversion itself.</li>
</ul>
<p>Overall, Gollner provided an excellent overview of what it takes to do a successful conversion, whether it be a conversion to DITA, or a conversion to some other XML format.</p>
<p>The last regular session I saw was <em>Using Task Modeler to Streamline DITA Content Development</em>, by Mark Wallis of IBM.  This was a demonstration of IBM&#8217;s Task Modeler.  In addition to demonstrating the software, Wallis described the methodology his team uses to structure content.  They design &#8220;Task Support Clusters,&#8221; which provide conceptual, task, and reference information as a self-contained cluster of DITA topics.  They use a minimalist approach, but try to keep each cluster independent, to the extent of avoiding links outside the cluster.</p>
<p>The software helps with the mechanics of setting up a cluster by helping authors visually build ditamaps, develop initial topics, build relation tables, and build a skeleton cluster.  The interface looked straightforward, and I&#8217;ll be trying it out.</p>
<p>The closing keynote was titled <em>Living Multiple Lives: The New Technical Communicator</em>, and was presented by Noz Urbina.  He talked about findings from techdoc evaluations his company has done for several companies, but the main focus was on distilling those ideas into suggestions on &#8220;What to do on Monday&#8221;?  In other words, what can participants do when they get back to work next week to improve their environments.</p>
<p>He did what a closing keynote speaker should do; he summed up the main points of the conference, which I take as the following:</p>
<ul>
<li>Moving to XML can gain significant productivity.  He cites the potential for 15-30% reductions in localization costs, and another 15-30% savings from reuse.</li>
<li>You don&#8217;t get these benefits by buying some tool; in fact, selecting tools should be one of the last things you do.</li>
<li>You need to understand your needs and use cases first.</li>
<li>The job of technical communicators is rapidly changing, mostly for the better.  But, to take advantage of those changes, communicators need break out of the &#8220;manual box,&#8221; establish a business-driven strategy, and work closely with other parts of their organizations.</li>
<li>Agile methodologies can be a good thing for communicators because they pull communicators into the process early on, and the methodology takes documentation seriously.</li>
</ul>
<p>Overall, I found the conference to be useful, both through the talks and through interactions with other attendees.  There was a manageable number of people, and I had the good fortune to speak with many of them, including several of the speakers.  There was a casual atmosphere that encouraged discussion with the speakers and other attendees.  The facility was excellent and the logistics were handled cleanly and efficiently.  Overall an excellent conference.</p>
<img alt="" border="0" src="http://feeds.wordpress.com/1.0/categories/rlhamilton.wordpress.com/79/" /> <img alt="" border="0" src="http://feeds.wordpress.com/1.0/tags/rlhamilton.wordpress.com/79/" /> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/rlhamilton.wordpress.com/79/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/rlhamilton.wordpress.com/79/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/rlhamilton.wordpress.com/79/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/rlhamilton.wordpress.com/79/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/rlhamilton.wordpress.com/79/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/rlhamilton.wordpress.com/79/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/rlhamilton.wordpress.com/79/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/rlhamilton.wordpress.com/79/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/rlhamilton.wordpress.com/79/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/rlhamilton.wordpress.com/79/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=rlhamilton.wordpress.com&blog=675222&post=79&subd=rlhamilton&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://rlhamilton.wordpress.com/2008/05/09/day-3-doctrain-conference/feed/</wfw:commentRss>
	
		<media:content url="http://a.wordpress.com/avatar/rlhamilton-128.jpg" medium="image">
			<media:title type="html">rlhamilton</media:title>
		</media:content>
	</item>
		<item>
		<title>DocTrain: Day 2</title>
		<link>http://rlhamilton.wordpress.com/2008/05/08/doctrain-day-2/</link>
		<comments>http://rlhamilton.wordpress.com/2008/05/08/doctrain-day-2/#comments</comments>
		<pubDate>Thu, 08 May 2008 06:32:23 +0000</pubDate>
		<dc:creator>rlhamilton</dc:creator>
		
		<category><![CDATA[DocTrain]]></category>

		<guid isPermaLink="false">http://rlhamilton.wordpress.com/?p=78</guid>
		<description><![CDATA[Today was the first &#8220;official&#8221; day of the DocTrain conference.   Yesterday was a &#8220;pre-conference&#8221; workshop day.
Things started with 2 keynotes.  I was a bit late and only caught the secoind half of RJ Jacquez&#8217;s keynote: Bringing the Video Revolution to Technical Communication. This was primarily a demonstration of Adobe&#8217;s latest products, in [...]]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><p>Today was the first &#8220;official&#8221; day of the DocTrain conference.   Yesterday was a &#8220;pre-conference&#8221; workshop day.</p>
<p>Things started with 2 keynotes.  I was a bit late and only caught the secoind half of RJ Jacquez&#8217;s keynote: B<em>ringing the Video Revolution to Technical Communication. </em>This was primarily a demonstration of Adobe&#8217;s latest products, in particular, Adobe AIR.  While it looks cool, I didn&#8217;t see enough to get a sense of how well it would fit in with an XML environment.</p>
<p>The second keynote was <em>XML in the Wilderness</em> by Joe Gollner.  This was an interesting look at the history of XML and Content Management, which if nothing else has pushed me to check out Ted Nelson, Vannevar Bush, and Douglas Engelbart, three of the &#8220;fathers&#8221; of XML and content management.  Gollner is an entertaining speaker, who has obviously spent a lot of time thinking about SGML, XML, and Content Engineering.  The main points of his talk echoed his workshop, with the addition of some nice historical points.</p>
<p>The first conference session I saw was Ann Rockley&#8217;s <em>Component Content Management</em>.  She defines Component Content Management (CCM) as managing content on a granular level with each component having its own life cycle.  In her view, CCM is not well supported by most tools.  Since terminology is still vague, this can case problems, especially when an IT organization buys a CMS and assumes it will work as a CCM.  The problem is that most Web CM, Enterprise CM (ECM), and Digital CM systems don&#8217;t deal with chunks of information that aren&#8217;d documents or webpages.</p>
<p>Rockley then spoke about evaluating CMS software, highlighting a new publication, developed in conjunction with CMS Review, titled <em>XML Component Content Management Report 2008</em>, which evaluates CCM systems.  She also spoke about the importance of going beyond tools.  In her view, which I heartily agree with, &#8220;Successful CCM is about:</p>
<ul>
<li>Understanding your content</li>
<li>Understanding your user requirements</li>
<li>A solid reuse governance plan</li>
<li>Information Architecture (taxonomy, UI, workflow)&#8221;</li>
</ul>
<p>While tools are important, they are not the most important question.  Yet, tools considerations often dominate the discussion and distort evaluation.</p>
<p>The next session was <em>Single Sourcing House,</em> by Heidi Sandler of Siemens.  She used the analogy of building a house, which while occasionally strained, was an apt analogy for building a single sourcing system.   I was mostly impressed with some of her quantitative measures, which showed a significant (3-4x) improvement in productivity with the introduction of an XML based single sourcing system.  The other item of note was a suggestion to keep a written history about decisions.  Given how quickly things change in most organizations, this could be very useful.</p>
<p>I got a third dose of Joe Gollner in the next talk, which was titled, <em>Putting Everything Back Together Again: Delivering Effective Information Products.</em> This talk expanded on his earlier discussion.  He made the point that while preparation and design are important, a more flexible planning approach may be a better way to deal with the &#8220;Uncontrolled growth&#8221; that characterizes content management these days.</p>
<p>Gollner presented a few case studies that served to illustrate the wide variety of content applications out there and to emphasize the point that old style waterfall style planning is not necessarily the best way to approach content management design.</p>
<p>The last talk I attended was Rahel Bailie&#8217;s <em>Content Management Successes: Separating Fact from Fantasy</em>.  In a continuation of what is becoming a theme of this conference, she pointed out the common fallacy that leads people to think that &#8220;Tools are the engine,&#8221; when in fact, &#8220;Tools are the caboose.&#8221;   I know from hard experience that organizations tend to select tools too early, and often without any idea of what their needs really are.</p>
<p>She also gave a cogent description of how to look at the blizzard of features offered by most tools.  Her suggestion on evaluatiing features is to go beyond the &#8220;what&#8221; questions, like &#8220;do you have version control,&#8221; to more open questions like, &#8220;How do you handle version control.&#8221;</p>
<p>The other point that stood out for me was a discussion of &#8220;governance,&#8221; which emphasized the importance of understanding who owns processes and the budget, and understanding the depth of support, or political will, behind decisions.  She suggest being wary of support below the &#8220;C-Level,&#8221; i.e., CIO, CTO, or CEO.  And, she suggests using the tools of audience analysis on the people governing projects.</p>
<p>Again, an interesting day.</p>
<img alt="" border="0" src="http://feeds.wordpress.com/1.0/categories/rlhamilton.wordpress.com/78/" /> <img alt="" border="0" src="http://feeds.wordpress.com/1.0/tags/rlhamilton.wordpress.com/78/" /> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/rlhamilton.wordpress.com/78/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/rlhamilton.wordpress.com/78/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/rlhamilton.wordpress.com/78/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/rlhamilton.wordpress.com/78/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/rlhamilton.wordpress.com/78/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/rlhamilton.wordpress.com/78/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/rlhamilton.wordpress.com/78/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/rlhamilton.wordpress.com/78/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/rlhamilton.wordpress.com/78/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/rlhamilton.wordpress.com/78/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=rlhamilton.wordpress.com&blog=675222&post=78&subd=rlhamilton&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://rlhamilton.wordpress.com/2008/05/08/doctrain-day-2/feed/</wfw:commentRss>
	
		<media:content url="http://a.wordpress.com/avatar/rlhamilton-128.jpg" medium="image">
			<media:title type="html">rlhamilton</media:title>
		</media:content>
	</item>
		<item>
		<title>DocTrain: Day 1</title>
		<link>http://rlhamilton.wordpress.com/2008/05/07/doctrain-day-1/</link>
		<comments>http://rlhamilton.wordpress.com/2008/05/07/doctrain-day-1/#comments</comments>
		<pubDate>Wed, 07 May 2008 06:21:28 +0000</pubDate>
		<dc:creator>rlhamilton</dc:creator>
		
		<category><![CDATA[DocTrain]]></category>

		<category><![CDATA[Add new tag]]></category>

		<guid isPermaLink="false">http://rlhamilton.wordpress.com/?p=77</guid>
		<description><![CDATA[This week I&#8217;m in Vancouver at the DocTrain West Conference.  I&#8217;ll be posting each day on the sessions I attended that day.  I&#8217;ll cover the highlights and add comments.
Day one offered four pre-conference workshops.   I chose Content Engineering: Workshop, presented by Joe Gollner of Stilo International.  Joe is an excellent [...]]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><p>This week I&#8217;m in Vancouver at the DocTrain West Conference.  I&#8217;ll be posting each day on the sessions I attended that day.  I&#8217;ll cover the highlights and add comments.</p>
<p>Day one offered four pre-conference workshops.   I chose <em>Content Engineering: Workshop</em>, presented by Joe Gollner of Stilo International.  Joe is an excellent speaker, who kept us engaged for 3.5 hours.  It&#8217;s impossible to summarize the full seminar in a blog entry, so I&#8217;ll hit the high points and add a few comments of my own.</p>
<p>The workshop was a comprehensive introduction to Content Engineering, which Gollner defines as the &#8220;application of rigorous engineering discipline to the design and deployment of content management and content processing systems.&#8221;  He sees Content Engineering as a necessary means for controlling the explosion of both the volume and complexity of the content that organizations must deal with.</p>
<p>Gollner divides Content Engineering into two major activities: Content Management and Content Processing.  While many CMS vendors see Content Management as the overriding discipline, and other activities, like Content Processing, as subordinate, Gollner sees Content Processing as an equal, and in many ways more complex, discipline.  He also sees Content Processing as a weak link in many CMS offerings.</p>
<p>Following from an engineering approach, Gollner made some other important points:</p>
<ul>
<li>Metadata and link information must be treated as &#8220;first class&#8221; content; no different from any other content.</li>
<li>This means that metadata and links must be &#8220;detachable&#8221; from any CMS; i.e., you must be able to export this information in usable, non-proprietary form, something that not all CMS&#8217;s support.</li>
<li>Technology components must be &#8220;loosely coupled,&#8221; which means that interfaces must depend on the exchange of validated content, rather than depending on component to component interfaces like proprietary APIs.</li>
<li>Processing rules aka business rules must be treated like content and therefore be expressed independent of any particular technology component.</li>
<li>In general, must be able to export everything (content, links, metadata, processing rules, etc.) as processable content.</li>
</ul>
<p>He concluded with some general comments and a &#8220;Top Ten&#8221; list of guidelines.  The general comments centered around the importance of recognizing the content is inherently complex and getting more complex all the time.  Effectively processing content requires engineering discipline that covers the entire life cycle.  Doing this well is an elusive goal.</p>
<p>In the Top Ten list, without a doubt the most important point was &#8220;Don&#8217;t invest in Content Management technology too early.&#8221;  Gollner has seen many projects get &#8220;bogged down in molasses&#8221; by committing to CM technology to early.  Instead, he suggests focusing on Content Architecture and Content Processing first.  Having seen exactly the same thing happen, I heartily endorse this recommendation.</p>
<p>Another notable item in the Top Ten was: Take a &#8220;Customer Service&#8221; focus in delivering tangible benefits to real users.  All too often, the people who should be receiving new features and benefits from Content Engineering are forgotten and see little or no direct benefit.  It&#8217;s important to keep delivering benefits to real users and not just &#8220;cool toys&#8221; for internal users.</p>
<p>Overall, I found the session valuable and hope it is a harbinger of how the rest of the conference will go.</p>
<img alt="" border="0" src="http://feeds.wordpress.com/1.0/categories/rlhamilton.wordpress.com/77/" /> <img alt="" border="0" src="http://feeds.wordpress.com/1.0/tags/rlhamilton.wordpress.com/77/" /> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/rlhamilton.wordpress.com/77/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/rlhamilton.wordpress.com/77/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/rlhamilton.wordpress.com/77/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/rlhamilton.wordpress.com/77/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/rlhamilton.wordpress.com/77/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/rlhamilton.wordpress.com/77/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/rlhamilton.wordpress.com/77/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/rlhamilton.wordpress.com/77/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/rlhamilton.wordpress.com/77/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/rlhamilton.wordpress.com/77/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=rlhamilton.wordpress.com&blog=675222&post=77&subd=rlhamilton&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://rlhamilton.wordpress.com/2008/05/07/doctrain-day-1/feed/</wfw:commentRss>
	
		<media:content url="http://a.wordpress.com/avatar/rlhamilton-128.jpg" medium="image">
			<media:title type="html">rlhamilton</media:title>
		</media:content>
	</item>
		<item>
		<title>Article: Seven Tips for Living with Technology</title>
		<link>http://rlhamilton.wordpress.com/2008/04/28/article-seven-tips-for-living-with-technology/</link>
		<comments>http://rlhamilton.wordpress.com/2008/04/28/article-seven-tips-for-living-with-technology/#comments</comments>
		<pubDate>Tue, 29 Apr 2008 05:21:15 +0000</pubDate>
		<dc:creator>rlhamilton</dc:creator>
		
		<category><![CDATA[Commentary]]></category>

		<guid isPermaLink="false">http://rlhamilton.wordpress.com/?p=76</guid>
		<description><![CDATA[I&#8217;ve just published a new article, titled Seven Tips for Living with Technology, on The Content Wrangler.
The article looks at some basic strategies for keeping your sanity as you acquire and work with technology.  It is a significant re-write of a draft section of my book.  That draft section can be found at: [...]]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><p>I&#8217;ve just published a new article, titled <em><a href="http://thecontentwrangler.com/seven_tips_for_living_with_technology">Seven Tips for Living with Technology</a></em>, on <a href="http://thecontentwrangler.com">The Content Wrangler</a>.</p>
<p>The article looks at some basic strategies for keeping your sanity as you acquire and work with technology.  It is a significant re-write of a draft section of my book.  That draft section can be found at: <a href="http://rlhamilton.wordpress.com/outline/living-with-technology/">Living With Technology</a>.</p>
<p>If you&#8217;re visiting this site for the first time after reading one of my articles, welcome.  Stay for a while and check out other draft sections of the book.  The place to start is the <a href="http://rlhamilton.wordpress.com/note-to-participants/">Note to Participants</a>, which describes what I&#8217;m up to and how best to view the site.</p>
<p>If you haven&#8217;t visited <a href="http://thecontentwrangler.com">The Content Wrangler</a>, it&#8217;s worth a look.  It&#8217;s frequently updated, has a lot of good information, and has a large and growing community of people interested in content management and content management systems.</p>
<img alt="" border="0" src="http://feeds.wordpress.com/1.0/categories/rlhamilton.wordpress.com/76/" /> <img alt="" border="0" src="http://feeds.wordpress.com/1.0/tags/rlhamilton.wordpress.com/76/" /> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/rlhamilton.wordpress.com/76/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/rlhamilton.wordpress.com/76/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/rlhamilton.wordpress.com/76/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/rlhamilton.wordpress.com/76/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/rlhamilton.wordpress.com/76/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/rlhamilton.wordpress.com/76/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/rlhamilton.wordpress.com/76/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/rlhamilton.wordpress.com/76/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/rlhamilton.wordpress.com/76/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/rlhamilton.wordpress.com/76/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=rlhamilton.wordpress.com&blog=675222&post=76&subd=rlhamilton&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://rlhamilton.wordpress.com/2008/04/28/article-seven-tips-for-living-with-technology/feed/</wfw:commentRss>
	
		<media:content url="http://a.wordpress.com/avatar/rlhamilton-128.jpg" medium="image">
			<media:title type="html">rlhamilton</media:title>
		</media:content>
	</item>
		<item>
		<title>Article: Choosing an XML Schema</title>
		<link>http://rlhamilton.wordpress.com/2008/04/11/article-choosing-an-xml-schema/</link>
		<comments>http://rlhamilton.wordpress.com/2008/04/11/article-choosing-an-xml-schema/#comments</comments>
		<pubDate>Fri, 11 Apr 2008 16:12:27 +0000</pubDate>
		<dc:creator>rlhamilton</dc:creator>
		
		<category><![CDATA[Commentary]]></category>

		<guid isPermaLink="false">http://rlhamilton.wordpress.com/?p=75</guid>
		<description><![CDATA[Scott Abel, who runs The Content Wrangler, a website that focuses on content management, has posted an article of mine titled, Choosing an XML Schema: Docbook or DITA.
The article talks about how to choose the right XML schema for your needs, and despite my DocBook bias, I think it gives a &#8220;fair and balanced&#8221; treatment [...]]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><p>Scott Abel, who runs <a href="http://thecontentwrangler.com">The Content Wrangler</a>, a website that focuses on content management, has posted an article of mine titled, <em><a href="http://www.thecontentwrangler.com/article/choosing_an_xml_schema_docbook_or_dita/">Choosing an XML Schema: Docbook or DITA</a></em>.</p>
<p>The article talks about how to choose the right XML schema for your needs, and despite my DocBook bias, I think it gives a &#8220;fair and balanced&#8221; treatment of the subject.  While you&#8217;re over at the site, you may want to consider joining <a href="http://thecontentwrangler.ning.com">The Content Wrangler Community</a>, which calls itself, &#8220;The social network for content professionals.&#8221;  It has subgroups for everything from Blogging to Wikis.  Certainly worth checking out.</p>
<img alt="" border="0" src="http://feeds.wordpress.com/1.0/categories/rlhamilton.wordpress.com/75/" /> <img alt="" border="0" src="http://feeds.wordpress.com/1.0/tags/rlhamilton.wordpress.com/75/" /> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/rlhamilton.wordpress.com/75/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/rlhamilton.wordpress.com/75/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/rlhamilton.wordpress.com/75/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/rlhamilton.wordpress.com/75/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/rlhamilton.wordpress.com/75/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/rlhamilton.wordpress.com/75/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/rlhamilton.wordpress.com/75/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/rlhamilton.wordpress.com/75/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/rlhamilton.wordpress.com/75/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/rlhamilton.wordpress.com/75/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=rlhamilton.wordpress.com&blog=675222&post=75&subd=rlhamilton&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://rlhamilton.wordpress.com/2008/04/11/article-choosing-an-xml-schema/feed/</wfw:commentRss>
	
		<media:content url="http://a.wordpress.com/avatar/rlhamilton-128.jpg" medium="image">
			<media:title type="html">rlhamilton</media:title>
		</media:content>
	</item>
	</channel>
</rss>