Use Case: Reusing with Word and Loving It

Speakers

Johanne Lavallée
Ver-Mac Inc.

Start

September 12, 2018 - 2:00 PM

End

September 12, 2018 - 3:00 PM

Use Case: Reusing with Word and Loving It

Johanne Lavallée started working for Ver-Mac, a 60-year old small company that builds equipment for work zones such as variable message signs and arrowboards, controllable with touch screens, smart phones and fleet management software. The management mandated her to find a reuse solution. The starting point was the Atlanta 2013 STC Summit where the initial goal was to find out if DITA was the answer. Johanne selected every relevant session on DITA and reuse, and visited many vendors. She will discuss what that was like in 2013.

The work of Mark Lewis and solutions brought back from Summit along with a careful analysis of the needs and restrictions of the small company, led to choosing Word. Using SmartDocs to create topic-based content and a local SharePoint to keep the snippets, variables and conditions, Johanne managed to setup the technical documentation for the whole company and discovered she could reuse 70% and sometimes build whole manuals in two days.

This use case also shows quickly what kind of problems need to be addressed when doing documentation in French and English with variables and snippets. How to make snippets work for multiple models with the same master document, when some have less steps. You will also find out about the best practices, and the simplicity (no taxonomy) when reusing in this type of solution.

The three takeaways for this session:

  • The advantages and inconveniences of using Word and a Sharepoint as a main writing tool.
  • Findings on reuse to make a snippet work for different models and different languages.
  • One scenario to plan and organize a content strategy as a lone writer.

Frequently Asked Questions

When do education events take place?

Webinars are held every Wednesday afternoon from 2-3 PM EDT/EST (GMT-4/5).

A majority of online courses are held Tuesdays-Thursdays between 10:00 AM-1:00 PM EDT/EST (GMT-4/5), as to not conflict with webinar times.

When will I receive the GoTo Webinar instructions for an event?

Registered attendees will receive the GoTo Webinar instructions three (3) hours before the webinar begins, approximately at 11:00 AM EDT/EST.

Registered attendees will receive the GoTo Webinar instructions one (1) day before the online course begins.

To participate in a webinar and an online course, you must be able to access GoTo Webinar, STC’s online meeting space.  GoTo Webinar is a standard web seminar tool (no separate download required) and all you need is a reliable Internet connection and phone line, or a computer with VoIP capabilities.

I registered for an online course, what are my next steps?

Once you register for an online course, you will receive a confirmation receipt that day. A majority of our online courses uses Moodle, STC’s course management site, which attendees will receive the login instructions two (2) days before the course begins.

If you cannot access Adobe Connect and/or Moodle (as needed), then you will not be able to successfully complete an online course.

I registered for a webinar, but will be unable to attend. Will a recording be available?

If a registered attendee is unable to attend a webinar that day, they will receive an email with a link to the recording, and an evaluation link along with the PDF of the presentation.

I registered for a webinar and/or an online course, but cannot attend at that time. Will I receive a refund?

If a registered attendee is unable to attend a webinar and/or an online course, the cost is transferable to a future event, but is not refundable. Online registration closes one-two business days before the education event begins.

I want to take a specific course that isn't listed online. Will it be offered in the future?

STC rotates its courses every year as we try to offer the most popular ones within the first half of the year. Online courses are subject to change or are offered more than once per quarter. If a course is not listed, STC will offer it again in the following year.

Have an Education Question? Contact Us!

MORE DETAIL