• Share
  • Email
  • Embed
  • Like
  • Save
  • Private Content
[Workshop] Analyzing Your Deliverables: Developing the Optimal Documentation Library
 

[Workshop] Analyzing Your Deliverables: Developing the Optimal Documentation Library

on

  • 3,796 views

Presented by Nicki Bleiel at Documentation and Training LIfe Sciences, June 23-26, 2008 in Indianapolis....

Presented by Nicki Bleiel at Documentation and Training LIfe Sciences, June 23-26, 2008 in Indianapolis.

Documentation deliverables have evolved beyond manuals and online help in recent years, and with the emergence of Web 2.0, things are changing faster than ever. Technical communicators have many more options to enhance the user experience, and developing many of them provide the opportunity to work with other departments to find a more holistic approach to content development and delivery. But there is no one-size-fits-all set of solutions. This workshop will review the types of analysis you need to do to determine which deliverables are right for your project, your customer, and your company.

Other factors that can’t be ignored, such as translation needs, staff/time constraints, file size limitations, corporate image and control, and proprietary concerns will also be discussed, including:

Analyzing the Product

* Intended audience; delivery method (desktop, web application, etc.); competitor offerings; software development methodology. The UI as part of the Help system. Product Management expectations.


Identifying User Wants and Needs

* Preferences and expectations for information; work environment; knowledge and experience levels.


Ascertaining Internal Needs and Opportunities

* Working with Training, Support, and Marketing to reduce duplication and provide the user with consistent, useful information.
* Finding ways to incorporate information from other departments to improve documentation.


Accessing Deliverable Options

* What is the optimum mix for the product?
* The traditional: online help, manuals, embedded help, job aids, forums, web sites, technical support knowledgebases.
* Emerging trends: wikis, blogs, RSS feeds, software demonstrations, podcasts, and other collaborative tools. They can supplement and/or enhance the traditional. Or, they may be a better fit for internal knowledge management or marketing use.


Optimizing the Library

* Single-sourcing; best practices for structuring information; continuous publishing

Statistics

Views

Total Views
3,796
Views on SlideShare
3,794
Embed Views
2

Actions

Likes
1
Downloads
70
Comments
0

1 Embed 2

http://www.slideshare.net 2

Accessibility

Categories

Upload Details

Uploaded via as Adobe PDF

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment

    [Workshop] Analyzing Your Deliverables: Developing the Optimal Documentation Library [Workshop] Analyzing Your Deliverables: Developing the Optimal Documentation Library Presentation Transcript