A global leader in healthcare technologies hired Giselle Mazurat to create and update the operations guide, interface guides, end user guides, training materials, online help, and technical documents.

The most critical document was a drug dispensing guide for nurses.

Challenges

• The audience was very frustrated because they had difficulty finding information.
• Important information was either missing or outdated.
• Several screens were outdated.
• The audience found the screens difficult to navigate.
• Content was scattered in various documents.
• The document had to be written as the software was being developed.
• Developers were on the critical path so it was difficult getting their time.
• Specifications were written in a very cryptic form.

Solution

Giselle Mazurat provided the following solution:

• Performed audience analysis by asking questions such as: Who is the audience? What do they need to know? What is their computer expertise? When do they need to use the application? Where are they using the touch screen application? Why do they need to use it?
• Structured the text in a task-oriented manner to help the audience find How-To information more quickly and easily
• Asked subject matter experts knowledge-based questions to gather missing information
• Included callouts on complicated screens so the audience can navigate them more easily
• Analyzed the handheld specifications, release notes, and user logs to verify if any information was pertinent since there were commonalities between the touch screen and handheld application - a huge time-saver when writing to future developments
• Translated highly technical jargon into plain language so the audience can understand the content quickly
• Performed a substantive edit and a sanity check
• Coordinated documentation reviews to ensure accuracy and completeness then incorporated reviewers' comments

Result

Giselle Mazurat understood what the nurses needed in the guide, and wrote it appropriately to their needs - complete, accurate and in plain language. This saved the nurses time from decoding the meaning of information and fighting with technology while caring for patients.

The work was rated as excellent, and got rave reviews from management as well as the legal and regulatory departments.

A solution provider hired Giselle Mazurat to revamp an operations guide.

Challenges

• The audience was very frustrated because they found the document difficult to read and understand.
• Content was stored in different places and with different people.
• Content was written in a very cryptic style.
• Content included information the audience didn't need.
• The document was unattractive and clunky.
• The formatting was loud and inconsistent, which made the document look very confusing.
• Screens were untidy and blown out of proportion.
• Diagrams had crooked arrows all over the place.
• The time constraint was very tight - Had only a few weeks to restructure a 250 page guide.

Solution

Giselle Mazurat provided the following solution:

• Performed audience analysis by asking questions such as: Who is the audience? What do they need to know? What is their expertise? When will they carry out their tasks? Why do they need to use the application?
• Restructured the content to make it easy on the eye. No matter how complete and accurate the document, if it looks like a dog's dinner, the reader would not be inclined to pick it up.
• Used a simple, clean font for the body text and headings so the reader can find information more easily
• Used only one format for bullets and sub bullets, rather than crazy looking arrows and circles
• Tidied the screens by cropping crooked edges and reducing them to a reasonable size in order to make the guide more manageable
• Ensured that all the parts of the diagrams lined up properly and the arrows pointed to the right places so the reader can understand the concept illustrated
• Performed a substantive edit and a sanity check

Result

The client breathed a sigh of relief because the content was much more readable and easy to use. Giselle Mazurat saved their target audience time, money and frustration.

A major company needed to update very technical documentation for 30 subsystems - and they needed it fast!

Challenges

• Management wasn't sure whether to use Word or FrameMaker to develop the documentation.
• Content was stored in different locations and written by different people.
• Important content was missing.
• Existing content was outdated and formatted inconsistently.
• Several diagrams were drawn manually and needed to be included in the documentation.
• The subject matter experts were stressed out and on a critical path for deliverables so their time was at a premium.
• Several screens needed to be captured from the mainframe system.
• The content had to be structured properly so the documentation department can post it on the company's intranet.

Solution

Giselle Mazurat provided the following solution:

• Performed audience analysis by asking questions such as: Who is the audience? What do they need to know? What is their expertise? Why do they need to use the system?
• Developed one chapter of the guide in Word and another in FrameMaker to show management that FrameMaker was the more appropriate tool for their project
• Gathered all the content from different locations to incorporate it in the documents
• Interviewed subject matter experts to gather missing information and update content
• Made the formatting consistent to present the information more attractively for the audience
• Rewrote the content to provide a uniform voice
• Produced the diagrams in Visio to illustrate concepts that were difficult to explain in words
• Incorporated screen captures so the audience can understand how to navigate the system
• Prepared an index for each guide so the audience can find information quickly
• Performed a substantive edit and a sanity check
• Coordinated reviews with technical staff to ensure content was accurate and complete
• Coordinated reviews with documentation staff to ensure content met corporate standards
• Tracked the progress for each document to keep management up to date on completed milestones

Result

Eureka! Giselle Mazurat updated 30 documents - totaling over 1400 pages - on time and on budget. The client was relieved and very happy with the quality of writing and professionalism.

A major company needed to update and write governance documentation such as policies, technical security standards, technical security processes, technical security guidelines, and executive summaries.

Of critical importance were the technology security standards that explained how to secure information so it does not get in the wrong hands.

Challenges

• Some content was either missing or out of date.
• Accuracy was critical to protect the company from unnecessary expense or embarrassment. Documenting a recommendation or guideline as a mandatory standard can cause the department unnecessary expense of implementing technology not critical to securing private information. On the other hand, documenting a mandatory standard as a recommendation or guideline can cause an embarrassing security compromise if the technology is not implemented.
• The security analysts were stressed out and on a critical path to implement the technology to comply with standards so their time was at a premium.

Solution

Giselle Mazurat provided the following solution:

• Performed audience analysis by asking questions such as: Who needs to follow the standard? What is their technical background? Is the standard mandatory, recommended or a guideline? Why do they have to comply?
• Performed independent research to ask subject matter experts knowledge-based questions, thus saving them time from having to explain the basics
• Conducted meetings with subject matter experts to analyze whether the standard is mandatory, a recommendation, or a guideline
• Translated highly technical jargon into plain language so the audience can understand the standards quickly
• Edited the standards and performed a sanity check
• Presented the standards to subject matter experts and management to get timely input
• Coordinated technical reviews to ensure the standards were accurate and complete
• Coordinated documentation reviews to ensure the standards complied with the corporate style

Result

The client was satisfied with the work because the standards were accurate and complete. By taking great care to work with the experts to analyze the standards correctly, Giselle Mazurat helped saved the company money by avoiding unnecessary, expensive implementations, and protected them from embarrassing security compromises.

Call me to book a complimentary appointment to discuss how Giselle Mazurat can help you succeed in your next project.