|
|
|
2Much.net Bounces Back From Near Disaster in Third Party Billing Bust
Montreal, Quebec (January 27, 2004) – 2Much Internet Services, the company responsible for last year’s surprise entry in high-end video-audio streaming and billing software, LiveCamNetwork 1.9, was forced to a standstill over the weekend of January...
CRM Offshore Software Development
CRM stands for Customer-Relationship Management, and adopts the basic of self-service channel such as the Internet.
CRM (Customer Relationship Management) is a business strategy built around the concept being "customer-centric". The main goal...
Speak Freely - Voice-Over-IP Taking Root
Years ago, I tried to convince my parents, who lived about three hours away from me, to install a program called PGPfone on their computer so they could call me online for free (as a bonus, it was encrypted, so nobody could eavesdrop on their...
The Best Web Design Programs
Who doesn’t own a webpage nowadays? If you’re thinking about spicing up your webpage or (heaven forbid) move your webpage off that blogging host, consider some of these web design programs that will make mastering the art of html a breeze (well, not...
Who is watching You?
Which is your preferred reality TV show: Survivor, Real World, American Idol, The Bachelor and The Bachelorette, Big Brother, Dog Days, Starting Over, or Temptation Island? Or is it Paradise Hotel, Playing it Straight, Mad Mad House, Love Cruise,...
|
|
| |
|
|
|
|
|
|
Successful Documentation Projects – Part 1 of 3 – ‘Understanding’
The creation of user documentation is a big component of any software project. Unfortunately, it’s often undervalued and left to the last minute. But that doesn’t mean it should be without a good management plan.
This is the first in a series of three articles outlining the key elements of a good user documentation process. It’s kind of an “ideal” process; very few projects will be able to implement every step, and some will require additional steps. Nonetheless, it should provide you with a good foundation (especially if you’re new to user documentation management).
Here’s an overview of the three articles.
Article 1 (this article) – Understand
•Identify your scope
•Familiarise yourself with the work environment
•Familiarise yourself with the product
•Identify the audience for the documentation
•Specify perceived audience requirements
•Roughly estimate doco project duration and resources
•Research audience requirements
Article 2 – Specify (See http://www.divinewrite.com/docoprocess2.htm)
•State your goals
•Write your concept specifications
•Design some possible implementations
•Conduct usability testing on your prototypes
•Write your requirements specifications
•Estimate project duration & resources
•Conduct usability testing on your writing sample
•Write your work pracs & design specs
Article 3 – Write (see http://www.divinewrite.com/docoprocess3.htm)
•Write the doco
•Manage production
So here goes…
Understand Your Project
Identify Your Scope
The first step in any project is to identify exactly what you’re expected to do. Generally this will happen before you take on the job, but it should still be the first thing that you document. Identifying your scope involves figuring out where you fit in the overall development process and where you fit within the company. No documentation project is ever just documentation, so it’s important to know exactly what else is involved. Some of the other areas that documentation people are/should be commonly be involved in include:
•Spec review
•GUI review
•Product user requirements research
•Documentation audience requirements research
•Usability testing
All of these things are integral to the development process, and should be scheduled properly.
Familiarise Yourself with the Work Environment
Get to know everyone involved in the product. For a software project, this will mean the project manager, the designers, and the guys that will be doing the low-level coding. Try to have a really good relationship with them. They have to respect you, otherwise they’re not going to listen to much of what you have to say.
Familiarise Yourself with the Product
Find out what’s going to be involved in the product. You must know:
•what are the goals of the development
•what user requirements they are trying to meet
•how the product will be used
•who will be using it
•what the features of the product are
•how the product will look and feel
•will it require a specific doco design? For instance, it may only run on the latest version of Windows, it may have a particular look and feel, a particular environment (that the help may have to be integrated into), etc.
These are all things that you may have input into, either through simple critique, or through input into user research requirements. Try to read as much documentation as you can find, and interview as many people stakeholders as possible. As you go, note down any issues you identify, any questions you have, or anything you think needs to be different.
Some (non-human) sources that you can utilise to achieve this include:
•Feature and product specifications
•Project plans
•Funding application documentation if applicable
Identify the Audience for the Documentation
Discuss with the project manager (and other stakeholders esp. marketing) the perceived user/audience.
Specify Perceived Audience Requirements
Make some educated guesses about audience requirements so you’ll be able to provide a rough estimate of product duration and resource requirements.
Discuss with the project manager (and other stakeholders esp. marketing) the perceived user requirements that the help must satisfy. See if someone has researched user goals, tasks, and the mental models users employ when using the product (or similar products). If they haven’t, interview inhouse experts to identify perceived goals, tasks, mental models, etc.
Secondly, you should identify what the theory says about user documentation (i.e. documentation approach, visual considerations, indexing considerations, etc.). I recommend Minimalism Beyond the Nurnberg Funnel, (1998) edited by John M. Carroll.
Roughly estimate doco project duration and resources
Although, by this stage, you don’t really know enough about the product or your audience requirements to know how long the documentation will take to complete,
management will nonetheless like a rough estimate. This is OK, as long as everyone is aware that it is a VERY rough estimate, and subject to change pending further knowledge and research.
This initial estimate must incorporate all of the time you’ll spend on the stages that occur before and after the writing stage. Remember, these stages are important, and should not be short-changed. (TIP: In a well managed project, planning should take approx 30% of your time, writing 50%, production 19%, and evaluation 1%.)
Estimating pre-writing stages
Allowing for the pre-writing stages is trickier than allowing for writing. If you’re having trouble, estimate the writing stage, then base all other estimates on that, using the above figures as a guide.
Estimating writing and post-writing stages
Because you probably still don’t know a great deal about the product or the users, your estimate here will be based primarily on a combination of past records, experience, intuition (gut feel), and industry standards in combination with the goals and tasks you’ve already specified. Start with the following steps.
1.Estimate the quantity of work required to document the tasks the user will need to perform to achieve their goals.
2.Track down any previous doco records. See if you can cross reference the time taken to produce similar doco in the past with the current quantity estimate. Derive a figure based on this method.
3.See how this compares with the estimate derived from industry standard figures (e.g., I think the current industry standard is to allow 1 day per page of documentation – this covers all drafts and reviews).
4.Compare the two figures and determine a good compromise based on your experience and intuition.
5.Figure out how long you actually have to do it, then how many writers you’ll need to get it done during this time.
6.Draw up a project schedule using something like Microsoft Project. Don’t forget to allow time for recruiting, training, and writing work practices.
TIP: At this stage, you should write the first draft of the Documentation Project Plan. It should include or refer to all of the steps outlined in this document. Basically, it should reflect the process advocated here, but be specific to the project you’re working on. It should also include a timeline.
Research Audience Requirements
Research on the users of the product and the audience of the documentation is one of the most important parts of any successful product. Unfortunately, it is also one of the most often overlooked aspects of any project. This generally occurs because decision makers feel they already know pretty much everything there is to know about the users and audience.
When managing a documentation project, you should investigate the chance of conducting research. If you’re employed late in the product life cycle, you should ask if user research has already been conducted for the product itself. If it hasn’t, there’s a good chance you won’t get support for audience research.
Audience research should seek to identify:
•user goals (what the user hopes to achieve with the product)
•user expectations of the doco (Manuals? Online help? Tutorials?, usability requirements, localisation requirements, etc.)
•user mental models (how they already see online help, what impressions they have of it, etc.)
•user tasks (how the user uses the product to achieve their goals)
•which users perform what tasks (user/task matrix)
•how long have users been doing these tasks?
•which tasks are one-off and which are repeated?
•did they ever do them differently?
•do they do a variety of tasks, or just a few?
•do they hate doing it? (is it tedious, repetitive?)
•do they find it difficult?
•which tasks are considered essential?
•are they normally under pressure when they do the task?
•are there other distractions (environmental, social, etc.)?
Some research methods to consider are:
•Observation of users doing their work in their work environment
•Focus groups and interviews with users
•Questionnaires
TIP: For further details on these methods, take a look at Managing Your Documentation Projects by Hackos (1994), User and Task Analysis for Interface Design by Hackos & Redish (1998), Social Marketing: New Imperative for Public Health by Manoff (1985), Designing Qualitative Research 2nd Edition by Marshall & Rossman (1995), and “Conducting Focus Groups – A Guide for First-Time Users”, in Marketing Intelligence and Planning by Tynan & Drayton (1988).
To be continued… See part 2 of this article - http://www.divinewrite.com/docoprocess2.htm - for information on preparing your specifications.
About the Author
* Glenn Murray is an advertising copywriter and heads copywriting studio Divine Write. He can be contacted on Sydney +612 4334 6222 or at glenn@divinewrite.com. Visit http://www.divinewrite.com for further details or more FREE articles.
|
|
|
|
|
| Tucows Downloads - Download Freeware and Shareware Software |
| Download freeware, shareware, and demos. Maintains over 45000 software titles that are tested, rated, reviewed and ready to download. |
| www.tucows.com |
|
| Free Software Downloads and Software Reviews - Download.com |
| Download shareware, freeware and Demo software for PC, Mac, Linux, and Handhelds categorized into categories, plus software reviews. |
| www.download.com |
|
| Computer software - Wikipedia, the free encyclopedia |
| This includes application software such as a word processor, which enables a ... Application software is often purchased separately from computer hardware. ... |
| en.wikipedia.org |
|
| Shareware.com - Search for shareware programs and free software ... |
| Search for shareware programs from more than a dozen downloadable software directories. |
| www.shareware.com |
|
| Jumbo: Free & Shareware MP3 files, Games, Screen Savers & Computer ... |
| Source of free and shareware computer programs and utilities for PC and Mac. Evaluate software and read product reviews. Download games and screen savers. |
| www.jumbo.com |
|
| Computer Software in the Yahoo! Directory |
| Browse categories featuring sites devoted to computer software, including shareware and freeware download sites, operating systems, desktop customization, ... |
| dir.yahoo.com |
|
| IEEE Software |
| IEEE Computer Society's magazine covering all aspects of software, including software engineering. |
| www.computer.org |
|
| Free Downloads on ZDNet | Shareware, Trialware, Evaluation Software |
| ZDNet's Software Directory is the Web's largest library of software downloads. Covering software for Windows, Mac, and Mobile systems, ZDNet's Software ... |
| downloads.zdnet.com |
|
| FSF - The Free Software Foundation |
| Free software is a matter of liberty not price. Think of "free" as in "free speech". |
| www.fsf.org |
|
| Apple - Software |
| Software products for your digital life. ... The perfect addition for professional review. QuickTime Broadcaster. Encoding software for live events. ... |
| www.apple.com |
|
| Open Directory - Computers: Software |
| In Partnership with AOL Search. about dmoz | report abuse/spam | help. the entire directory, only in Computers/Software. Top: Computers: Software (38471) ... |
| dmoz.org |
|
| freshmeat.net: Welcome to freshmeat.net |
| About: The Web browser is probably the most frequently used software today, ... Web professionals can use the software for functional testing and regression ... |
| freshmeat.net |
|
| Software - GNU Project - Free Software Foundation (FSF) |
| Listing of the GNU software packages. |
| www.gnu.org |
|
| Sun Software |
| Get enterprise-class software--Solaris 10 OS, the Java Enterprise System, ... Sun Java StorageTek Software reduces cost and complexity with a single, ... |
| www.sun.com |
|
| Internet Real Estate.com -- owns and operates a portfolio of the ... |
| SOFTWARE.COM · SWEEPSTAKES.COM · PHONE.COM PODCAST.COM ... Software.com | Sweepstakes.com | Phone.com | Podcast.com | Shop.com | Safety.com ... |
| www.internetrealestate.com |
|
| Joel on Software |
| A weblog by Joel Spolsky, a programmer working in New York City, about software and software companies. |
| www.joelonsoftware.com |
|
| Amazon.com Software: Computer & video games, business, accounting ... |
| Online shopping for computer & video games, business & office productivity software, software from Microsoft, Apple, Adobe & more; accounting, antivirus, ... |
| www.amazon.com |
|
| IBM Software - Home Page |
| IBM home page for all of its software products, including Lotus and Tivoli, with keyword search, category browse and AZ product names. |
| www.ibm.com |
|
| Opera web browser: Homepage |
| Copyright © 2006 Opera Software ASA. All rights reserved. Skip navigation. Opera Software ... Copyright Opera Software ASA . All rights reserved. ... |
| www.opera.com |
|
| Google Directory - Computers > Software |
| Search only in Software Search the Web ... Software Categorized by Letter: A B C D E F G H I J K L M N O P Q R S T U V W X Y Z ... |
| www.google.com |
|
|