Re: Content Delivery

Subject: Re: Content Delivery
From: Chris Despopoulos <despopoulos_chriss -at- yahoo -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 16 Dec 2015 12:39:20 +0000 (UTC)

Looking at the WIKI entry for EPSS, I see a desire to focus on specific tasks, and be able to provide procedures for each task a user could need for a given application or set of applications. I tend to think that's not even possible... It's like documenting a language by providing an example for every possible sentence. For initial exposure you need to learn specific didactic procedures -- sort of like an initial phrase book. But there's a point where you need to learn the grammar and vocabulary.
But there are good ways to aid tasks. You should look at walk-through documentation. Drupal has a walkthrough module, and I believe there are companies out there that provide software to create these. The idea is that you choose a procedure, and the GUI displays flags (tags??? balloons???) that show where to do each step, and give whatever explanations you want.Â

In our product we use progressive disclosure... Tooltips, content on the GUI surface, overlays you can invoke for each panel of the GUI, and full online doc. I'm a big fan of keeping content as close to the GUI as possible, and giving the user avenues to take that gradually lead away from the GUI as the content becomes more abstract/conceptual.Â

Our help system performs dynamics in the client, at the last minute. So we can get information about the state of the user (role, for example) or the product (execute API calls), and modify the docs accordingly. We haven't had a chance to experiment fully with this -- I imagine that we could look at the product and provide in-depth descriptions of the current state -- not just WHAT the state is, but WHY. But that's a question of time to experiment. Another thing we can do is merge remote documentation. As our product begins to incorporate remote components, the docs can sit with those components and be merged if you are a user with access to the given component. And we can also merge content from remote sites like our social web... Search can include hits from the forum, and if I wanted to I could incorporate content from forum posts.
I think content delivery is on a threshold of change. The network is becoming much more dynamic than ever before, and doc delivery has to keep apace. So you're doing the right thing by asking about this and looking for possibilities beyond the usual.Â

BTW, the age-old response... "What do your customers USE for docs?" isn't quite appropriate. The question is, what do your customers need in order to future-proof their experience with docs? If they already had it in their hands, then it would probably not be appropriate for the next wave of technology. My opinion, anyway...
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Previous by Author: Re: same-named heading1s in different chapters ?
Next by Author: Unerase 7z file?
Previous by Thread: Re: Content Delivery
Next by Thread: Re: PDF link checker?


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads