Written by Sarah Maddox – Technical Writer. http://author-it.com/i8exmd

I’m attending the TCANZ Conference 2010 in Wellington, New Zealand. Matt Armstrong from Author-it gave a good, simple demo of Author-it Assist and an introduction to Author-it Aspect. These are the notes I took during the session. All credit goes to Matt. Any mistakes are mine.

Author-it Assist sounds very interesting. It can contextually link any application to any content. It works on Windows desktop applications as well as web applications.

It is performance support software (from Sarah: similar to guided help, from my understanding). It works with all enterprise IT applications, and lets you push multiple topics to the user’s desktop.

As a the help author, you select the relevant bit of the application (such as a frame or other UI element) then drag and drop the URL onto the application, to indicate that it constitutes the help for that specific screen or UI element. Your content can be delivered from any source: HTML, Word, PDF, etc. Anything that you can display in a browser.

The user sees an “Assist me” tab. When they click it and select a topic, Assist shows a side panel displaying the relevant content. This is the content that the author has marked as relevant.

Assist hooks into the UI elements of the page. It has a fuzzy logic to protect it from UI changes as much as possible.

It’s also available as a set of SDKs. You can download a free copy of the API.

Author-it Aspect is the tool that knows who you are. Based on who you are, it will dynamically filter the information sent to you, including the search information. For example, it can choose the content in the correct language for a particular user. I didn’t get as good an idea of what this one can do, but it’s worth going to the Author-it website to read up on it.

Thank you Matt for a great insight into two tools in the Author-it suite.

One of the most striking issues facing our clients is how to extend Author-it’s collaboration further across their organisation.

The ubiquity of Word, PDF and email means these tools are a familiar, and therefore de facto, method to share and check content everywhere, but they offer poor methods for groups to collaborate.  I know Word and PDF both have review and collaboration features and I’ve seen some brave efforts to actually make these functions work.

After all, the thinking goes, if Word and Adobe Reader are on every desktop it’s easy to distribute a file and allow 50 people to comment directly in the document.

But this doesn’t scale – it’s a simple as that.  No matter how sophisticated your SharePoint system, or the forceful personality of your project manager, amalgamating and approving the comments from more than a few people is an arduous and error-prone task for the people responsible for managing the review process.  There’s either the comments from 50 people in one document (not pretty), or 50 documents with comments from one person.

So how to solve the problem? How to continue using a document distribution method that everyone is comfortable with, but keep the granular control and consistency that Author-it provides.  All without making the review process more difficult or timeconsuming.

We decided the best way to achieve these goals was to start where people are familiar (Word and PDF) and use this document as an entry point to Author-it.  That is, automatically create links to the relevant Author-it content directly within the Word or PDF file.

When a reviewer wants make changes or suggestions to any part of the document they simply click the link next to that section.  This opens the relevant Topic in Author-it for the reviewer to begin making changes immediately.

Because the review is now taking place directly in the original content source, all of the standard Author-it content controls, workflow, reuse, and release functionality applies.

The Word or PDF file no longer become the platform for collaboration, a task neither perform well.  Instead the Word and PDF file remain what they should be, a distribution and publication format, now with added benefit of linking directly to the original (controlled) source with proper collaboration.

As per I’ve created a short video http://www.author-it.com/videos/collaboration/Collaboration%20Plus_demo.swf to outline workflow and a few business cases.  Please check and let me know what you think.  This functionality will be freely available to all Author-it users but requires some scripting skill to configure for your own domain and database details.

(Just a summary for people unfamiliar with Author-it – software licencing is concurrent.  This means the Windows software can be installed on any number of PCs (the web version, obviously, doesn’t need installing on any user’s computer).  The software is smart enough to know who you are and configure functionality appropriately.  That is, no separate ‘review’ or ‘lite’ copies are required – if you are a reviewer the ‘advanced Author-it functions’ are automatically switched once you have logged in.)

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

With a background in education I’ve been interested in a number of blogs and articles that have come up over the past few months regarding ‘open source collaboration’ for instructional material.  Anyone who has used a wiki knows the general idea: ubiquitous, collaborative authoring by motivated experts un-encumbered by geographic location or commercial constraints.  In some areas, though, a wiki is a very poor choice.  Its egalitarian nature, informality and generally more limited formatting becomes the other edge of the sword.  The ‘heat/light’ ratio changes and users lose confidence in the quality of information.
Beyond the hype of open source (Free software!  No vendors!) lies the real beauty – altruism and belief that information should be shared.  There are some amazing projects by universities to enable professors and industry experts to collaborate on curricula for a wide range of disciplines, from electrical engineering through to agriculture husbandry.  A baseline of material was provided and users can contribute, extend and filter to meet their needs.  Schools and universities are then free to incorporate this curricula into their own programmes.
Here at Author-it we have a large community of intelligent users that have taken the core Author-it software and solved some very complex problems.  We get to hear about it but the information often stays locked inside peoples’ heads or drifts around the user community as anecdotes and rumour.  So, in keeping with the spirit of open source we have made the (very purple) ‘Using Author-it’ guide available as an open source project.  Our own product Author-it Live provides the ubiquitous, collaborative authoring interface via a standard web browser, to anyone, anywhere.  With our long experience in the documentation and publishing industry we believe quality and accuracy are critical and shouldn’t be sacrificed just to get web-based collaboration.  Author-it Live’s controlled workflow ensures that all articles go through peer-review before being made ‘live’.
At this early stage a small group of users will be contributing articles, and this community will grow.  The evolving ‘Using Author-it’ guide will be made available online, and for the old school ‘curl up on the couch with a cup of tea’ people, a regular update to the hard copy will be found on Amazon. (update – the ‘Using Author-it’ guide has sold out already, sorry.  More copies on their way to Amazon’s warehouse early next week)

I’d be interested in feedback from readers about the strengths, weaknesses, joys and disappointments of your own open collaborative efforts…
Posted by Matt Armstrong, Sales Director Asia Pacific, Author-it Software Corporation

Clarion Suite getaway
Melbourne, Australia

Join us on Monday 20th October for a FREE information afternoon and learn how to:

• Collaborate across geographically dispersed teams
• Manage your documentation for product and language variations
• Reduce information risk and increase efficiency
• Improve employee effectiveness

Let our industry experts Matt Armstrong and Richard Ashurst show you how many of our US and Australian clients solved these issues with Author-it.

For more information please click here.