Author-it Software Corporation is the world's leading provider of component content management software. Over 3500 clients in 50 countries are content in the knowledge that they have chosen the most reliable and proven system for authoring, content management, language translation management and single-source publishing to multiple outputs.
The Author-it Blog

WEDNESDAY, 03 DECEMBER, 2008

Moving to Structured Content in A Crazy Ad-hoc World

This post is a more ‘fleshed-out’ version of my response to a question posed by Gordon Maclean (http://www.onemanwrites.co.uk/), but the question is common: “Now that I know I want to, how do I move from an unstructured environment to a structured environment?”.  The Author-it team attend many conferences both in speaking capacities and as vendors.  We get the chance to talk to people from a huge range of organizations, from the battle-scarred people on the cutting edge to those who have only just started thinking about how structured content will benefit them.
The benefits of well structured content can be quantified very easily, especially when this discipline is applied to the broader organisation.  In almost all cases one of the biggest hurdles is working out how long (and how much) to get from where you are to where you want to be. Once the enthusiasm of DITA or custom schema dies down and people realize how much effort will be involved in migrating or re-writing existing content in order to comply, at the same time as meeting their day to day work requirements, the task has become huge and the true cost almost unknown.  Every hour that a team don’t spend writing (meetings, problem solving, struggling with a new tool, can’t publish the content, etc), every hour a developer spends updating a schema/specialisation/XSLT, every day a project slips, all add to the true cost of the project.  When management add this up the cost of tools is often minor in comparison.
According to our clients this has been the biggest gap - managing and evolving non-compliant Topics when the technology requires compliance to deliver an output - eg. the XSLT or DITA Toolkit chokes because your content isn’t yet fully compliant.  We talk to a lot of organizations migrating from Frame/RoboHelp/Flare (and even Word) and regardless of technology the big hurdle is the need to continue meeting deadlines while migrating from unstructured content to structured content.  For some it’s easier to draw a line under the current content assets and start from scratch.  This is a decision that effectively writes off all of the accumulated value of existing content - knowing this value, and the associated cost of migration, and deciding it’s cheaper to start again.
Not everyone can make that decision and so clients look for migration strategies that allow segmenting of content, evolution, and tools that support them during evolution.
In the 5.2 release of Author-it we’ve added template-based structured authoring where, once content is imported (or written), you can apply a DITA or other structure over the Topic and see exactly where you do and do not structurally comply.  Once your Framemaker or RoboHelp document is imported you immediately see which Topics are compliant and which are not, but you can still publish your document.  You can continue to meet deadlines and always have complete visibility of which Topics in which projects need to be updated to meet your structure standards.
The Author-it Structures are templates that can be applied to groups of Topics.  If you change the template, all Objects inherit the new structure rules (or show you they now fail to comply).  Workflow controls mean Topics *must* comply at certain Release States (’Draft’ can be non-compliant but ‘Released’ must be compliant), and Publishing Profiles remove all non-compliant topics during publishing if you plan to use the DITA Toolkit or similar XSLT processor.
You can check out my short video on structured authoring

Posted By: Matt Armstrong,Sales Director Asia Pacific, Author-it Software Corporation

SUNDAY, 09 NOVEMBER, 2008

Welcome to the Author-it blog

Steve Davis, President, Author-it Software CorporationWelcome to the Author-it Blog.

It’s been an interesting journey working with our team to conceive, create and now deliver the Author-it Blog.  I previously thought of Blogs as the ramblings of people who ‘didn’t have a life’. They filled this void through endless hours of musing on subjects of great interest to themselves but of little interest to anyone else. So I did a bit of research; I looked at some blogs both within and outside our industry and ended up at the ’source of all knowledge’… Wikipedia.

A few things stood out to me in the Wikipedia definition… commentary, online diary, network, and community. The ‘community’ aspect in particular tweaked my interest.

For many years the Author-it User Group has formed a fabulous part of what we are to the marketplace.  It provides an invaluable link between users. A place where they could share ideas, ask questions, provide tips to users and feedback to us.  It really is a community.

I see the Author-it Blog extending this community aspect by providing a medium for greater participation by our Author-it team.

The vision is a vehicle to open the doors of the company. To allow our clients, partners and prospects the chance to look inside Author-it, to meet us, ask questions and share ideas.

Commercial reality dictates that some of the amazing ideas and creativity that flows through Author-it sometimes have to be restrained, but I’d like the Author-it Blog to be a place where we can post our opinions, ask questions, solicit feedback and share our perspective with you.

While we are obviously biased, our perspective is born of more than a decade in the industry, tens of thousands of prospect meetings and over 3,500 client implementations all around the world.

I expect that we will challenge some of the general thinking out there.  Author-it has never been afraid to be different where we believe we are right.  We seek to solve business problems, not the symptoms.  To us the solution is always more important than specific technology fads or standards purported to be the only way to solve the problem.  In this, I hope we are able to stimulate debate and debunk some of the myths we believe exist in the market.

A blog is nothing if not read, thought about and responded to.  Your feedback is important to us and will help us improve this blog and its value to all.  Please comment on our posts, and if you feel the need, contact me personally with any additional thoughts.

Thanks and best regards,

Steve

Steve Davis
President, Author-it Software Corporation
Posted on 09/11/08 in Welcome to the Author-it blog