Adobe Robohelp

Get new posts delivered straight to your inbox.

Subscriber count: 4,039

Stitcher radio

follow us in feedly

Want more tech comm blogs to follow? See my Tech Comm Collection of Blogs on Feedly.

Adobe FrameMaker

The Enterprise Help Authoring Problem

Feb 16, 2011 • general

In my organization, we're in the middle of trying to come up with a solution to address enterprise-wide help authoring. Currently we have a lot of pocket groups of writers working in silos. We think an enterprise-wide solution that unifies help authoring would be a step forward.

Siloed Publishing versus a Unified Help Strategy
Siloed help authoring (left) versus a unified help authoring strategy (right). How do you make this shift?

I would love if it someone could recommend a solution. Here are our requirements.

Enable consistent-looking, attractive deliverables. Currently help across the enterprise takes all shapes and formats, since most authors work in silos using the tools they choose. Help produced by the different groups looks as different as help produced by separate companies. We want to create a consistent --and attractive -- look and feel to help materials produced by our organization.

Enable non-technical people to author. Sometimes non-technical writers, such as domain experts in business departments or project managers, need to author content. We need to a process that allows them to author comfortably without getting hung up with complicated authoring methods or tools. A simple authoring solution would also increase the likelihood that writers from the various silos embrace our solution.

Allow community members to collaborate. We have a wide number of community members who also need to collaborate on content as well. Community members are outside the firewall and may have only rudimentary technical skills. These community members volunteer their time and talent to work on documentation and other content projects. We need them to be able to author content, too.

Share and re-use content. We need to share and re-use the content that we create. We may be mixing and matching different topics in different outputs, and also working collaboratively on the same project. We want to leverage content re-use where necessary to allow us to compile different deliverables that draw upon the same content base, such as online help and printed guides and training guides.

Translate content. Much of the content we create needs to be translated. Translation department requires the content be in Word, XML, or UTF-8. Another translation group uses LingoTek.

Allow users to easily find the content. In addition to improving the authoring process, users also need to easily find the content. Some departments have thousands of pages of content. We need a way for users to search through that content to find the right information quickly.

Permission levels for certain kinds of content. Some content is permission-based, so only users in certain roles should be able to access it. All users with these permission level requirements have their role identified through a central identity access management system.

We're open to any solution at this point, and cost is not an overriding factor in the solution. We do have a thorough SharePoint integration internally as well as a robust Mark Logic database. Externally some content is on Mediawiki. Because of the size of the organization, we do have a lot of in-house experts. What would you implement for this situation?

follow us in feedly

Get new posts delivered straight to your inbox.

Subscriber count: 4,039

About Tom Johnson

Tom Johnson

I'm a technical writer based in the California San Francisco Bay area. Topics I write about on this blog include technical writing, authoring and publishing tools, API documentation, tech comm trends, visual communication, technical writing career advice, information architecture and findability, developer documentation, and more. If you're a professional or aspiring technical writer, be sure to subscribe to email updates using the form above. You can learn more about me here.