<?xml version="1.0" encoding="UTF-8"?><!-- generator="wordpress.com" -->
<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/"
	>

<channel>
	<title>doctrain &amp;laquo; WordPress.com Tag Feed</title>
	<link>http://wordpress.com/tag/doctrain/</link>
	<description>Feed of posts on WordPress.com tagged "doctrain"</description>
	<pubDate>Sun, 20 Jul 2008 06:27:06 +0000</pubDate>

	<generator>http://wordpress.com/tags/</generator>
	<language>en</language>

<item>
<title><![CDATA[Lots of tech pubs and content management conferences this fall]]></title>
<link>http://jwc.midasnetworks.com/blog/?p=116</link>
<pubDate>Wed, 06 Sep 2006 03:16:40 +0000</pubDate>
<dc:creator>annegentle</dc:creator>
<guid>http://jwc.midasnetworks.com/blog/?p=116</guid>
<description><![CDATA[For example, the FrameMaker Chautauqua is local to Austin in November
There are plenty of tech pubs ]]></description>
<content:encoded><![CDATA[<div class="documentDescription description"><strong>For example, the FrameMaker Chautauqua is local to Austin in November</strong></div>
<p>There are plenty of tech pubs related conferences to attend this fall.   This is by no means a thorough listing but these three have caught my eye   recently.</p>
<p>There's the <a href="http://www.cmprofessionals.org/events/summit/fall2006/">CM Pros Fall   2006 Summit</a> discussing Content Management and the World Enterprise at   the end of November (Nov 27) in Boston (early bird registration by the end   of September). It's held in conjunction with the <a href="http://gilbaneboston.com/">Gilbane Conference on Content   Technologies</a> conference so there's sure to be a neat mix of attendees   and sessions.</p>
<p>The <a href="http://www.travelthepath.com/conf/chautindex.html">FrameMaker   Chautauqua</a> is in Austin November 8-10, 2006. <a href="http://en.wikipedia.org/wiki/Chautauqua">Wikipedia has a nice   chautauqua entry</a>, loosely interpreted, it's a traveling meeting designed   to educate. The conference is located out by our airport but don't let that   stop you from coming downtown to eat and enjoy some live music. It'll be a   little late in the season for the bats under the Congress Avenue bridge,   unfortunately, but Austin has much more than bats to offer travellers. In   the spirit of Keeping Austin Weird, there's an <a href="http://www.glidingrevolution.com/">Austin Segway tour</a>, an <a href="http://www.austinducks.com/">Duck boat tour in Austn</a>, and an <a href="http://www.austinghosttours.com/">Austin Ghost tour</a>. There are   plenty other fun things to do in Austin so please do take a look around when   you're here. Try Zilker Park, Mount Bonnell, Lake Travis, and 4th Street for   starters.</p>
<p>There's also the <a href="http://www.doctrain.com/">Documentation &#38;   Training Conference</a> in Boston in early October (Oct. 3-5) and a few   members from BMC's Information Design and Development group are presenting a   <a href="http://www.doctrain.com/case_studies.htm">case study on Structuring   an Organization for Customer Focus</a>. Julia Osgood is one of the   presenters. She and I worked together on our Routes To Value documentation   team last year. Go and learn about our lessons learned while re-inventing   the organization of tech pubs groups.</p>
]]></content:encoded>
</item>
<item>
<title><![CDATA[Day 3: DocTrain Conference]]></title>
<link>http://rlhamilton.wordpress.com/?p=79</link>
<pubDate>Fri, 09 May 2008 06:17:23 +0000</pubDate>
<dc:creator>rlhamilton</dc:creator>
<guid>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-confer]]></description>
<content:encoded><![CDATA[<p>Today was the last "official" day of the conference.  Tomorrow (Friday) is a post-conference day of workshops.  Unfortunately, I need to leave early Friday, so I'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'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 "front stage" function; that is, the immediately visible parts of a system.  But, in fact, the "back stage" 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 "Moment of Truth," 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'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'm on the DocBook TC, I was particularly interested in this talk.  In general, I think Mulvihill'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've seen (I've done extensive work with DocBook, but much less with DITA, so I don'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'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'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's Task Modeler.  In addition to demonstrating the software, Wallis described the methodology his team uses to structure content.  They design "Task Support Clusters," 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'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 "What to do on Monday"?  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'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 "manual box," 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>
]]></content:encoded>
</item>
<item>
<title><![CDATA[DocTrain: Day 2]]></title>
<link>http://rlhamilton.wordpress.com/?p=78</link>
<pubDate>Thu, 08 May 2008 06:32:23 +0000</pubDate>
<dc:creator>rlhamilton</dc:creator>
<guid>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;]]></description>
<content:encoded><![CDATA[<p>Today was the first "official" day of the DocTrain conference.   Yesterday was a "pre-conference" workshop day.</p>
<p>Things started with 2 keynotes.  I was a bit late and only caught the secoind half of RJ Jacquez's keynote: B<em>ringing the Video Revolution to Technical Communication. </em>This was primarily a demonstration of Adobe's latest products, in particular, Adobe AIR.  While it looks cool, I didn'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 "fathers" 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'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't deal with chunks of information that aren'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, "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)"</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 "Uncontrolled growth" 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'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 "Tools are the engine," when in fact, "Tools are the caboose."   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 "what" questions, like "do you have version control," to more open questions like, "How do you handle version control."</p>
<p>The other point that stood out for me was a discussion of "governance," 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 "C-Level," 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>
]]></content:encoded>
</item>
<item>
<title><![CDATA[DocTrain: Day 1]]></title>
<link>http://rlhamilton.wordpress.com/?p=77</link>
<pubDate>Wed, 07 May 2008 06:21:28 +0000</pubDate>
<dc:creator>rlhamilton</dc:creator>
<guid>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]]></description>
<content:encoded><![CDATA[<p>This week I'm in Vancouver at the DocTrain West Conference.  I'll be posting each day on the sessions I attended that day.  I'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's impossible to summarize the full seminar in a blog entry, so I'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 "application of rigorous engineering discipline to the design and deployment of content management and content processing systems."  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 "first class" content; no different from any other content.</li>
<li>This means that metadata and links must be "detachable" from any CMS; i.e., you must be able to export this information in usable, non-proprietary form, something that not all CMS's support.</li>
<li>Technology components must be "loosely coupled," 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 "Top Ten" 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 "Don't invest in Content Management technology too early."  Gollner has seen many projects get "bogged down in molasses" 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 "Customer Service" 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's important to keep delivering benefits to real users and not just "cool toys" 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>
]]></content:encoded>
</item>
<item>
<title><![CDATA[Ready for DocTrain West]]></title>
<link>http://annegentle.wordpress.com/?p=207</link>
<pubDate>Fri, 02 May 2008 04:38:07 +0000</pubDate>
<dc:creator>annegentle</dc:creator>
<guid>http://annegentle.wordpress.com/?p=207</guid>
<description><![CDATA[
I&#8217;ll be at DocTrain West in Vancouver next Tuesday-Friday moderating the Meet the Bloggers se]]></description>
<content:encoded><![CDATA[<p><a href="http://www.doctrain.com/west"><img style="vertical-align:middle;" src="http://www.doctrain.com/west/images2008/logo.doctrain.west.jpg" alt="" width="250" height="45" /></a></p>
<p>I'll be at <a href="http://www.doctrain.com/west">DocTrain West</a> in Vancouver next Tuesday-Friday moderating the <a href="http://www.doctrain.com/west/program_detail/meet_the_bloggers/">Meet the Bloggers session</a> as well as co-presenting <a href="http://www.doctrain.com/west/program_detail/wiki_roundtripping_structured_authoring_how_do_they_co_exist/">Wiki Roundtripping? Structured Authoring? How Do They Co-Exist?</a> with <a href="http://ikiw.org/">Stewart Mader</a>.</p>
<p>I just put the finishing touches on our Wiki Roundtripping presentation and I have to admit I'm a little excited about it. While much of the focus will be on the DITA-Wiki Hybrid scenarios, there are at least two new scenarios that I've learned about since writing that white paper that we'll bring to the presentation.</p>
<p>The Meet the Bloggers session is apparently going to be popular, so I hope I can pull off the moderator role effectively. I'm no Oprah, but I do come from Cincinnati where Jerry Springer was once mayor. This session will be fun and I expect to learn from <a href="http://www.idratherbewriting.com">Tom Johnson</a>, <a href="http://www.thecontentwrangler.com">Scott Abel</a>, <a href="http://www.darrenbarefoot.com">Darren Barefoot</a>, <a href="http://www.dmncommunications.com/weblog">Scott Nesbitt</a>, and <a href="http://www.dmncommunications.com/weblog">Aaron Davis</a>.</p>
<p>Plus, I'm excited for the <a href="http://justwriteclick.pbwiki.com">Unconference sessions</a> Wednesday night. Completely experimental, but this conference seems like a great place to try out some different ways of sharing information off-the-cuff and informally.</p>
<p>Edited to add: <a href="http://www.webworks.com/weblog/aporter/2008/04/24/Unconferncing.html">Alan Porter was even inspired to update the Wikipedia entry for unconference</a> to add a definition. That addition is very useful. Way to go Alan!</p>
]]></content:encoded>
</item>
<item>
<title><![CDATA[Medical Art]]></title>
<link>http://medart.wordpress.com/2007/05/22/medical-art/</link>
<pubDate>Tue, 22 May 2007 19:54:25 +0000</pubDate>
<dc:creator>marshinfozys</dc:creator>
<guid>http://medart.wordpress.com/2007/05/22/medical-art/</guid>
<description><![CDATA[This is a blog focussed on medical, healthcare animations and training by digital means. Medical art]]></description>
<content:encoded><![CDATA[<p>This is a blog focussed on medical, healthcare animations and training by digital means. Medical art, healthcare animations.</p>
<p>CAMP and Doctor Training - <a href="http://doctrain.blogspot.com/">http://doctrain.blogspot.com/</a></p>
<p>CME and Nurses Training - <a href="http://nursetrain.blogspot.com/">http://nursetrain.blogspot.com/</a> </p>
]]></content:encoded>
</item>

</channel>
</rss>
