Writer

Doug MacMillan - Portfolio - Writer

Dimensional Insight Workbench Topic Samples (2014-2019)

These samples are on a live website for an IDE (Integrated Development Environment) software product. They were produced using MadCap Flare and Capture, using a Tortoise Subversion (SVN) source control repository. The samples listed are topics that I created from scratch to support new features. Much of the rest of the help system was generated by bringing forward preexisting PDF manuals from a previous version of the product. Note that this help system has multiple authors. I was responsible for about 60% of the content.


Dimensional Insight Training Samples (2014-2019)

These samples were produced using either MadCap Flare (single sourced from the Workbench Help) or MS PowerPoint.

  • Workbench Student Guide
    Intended use for stand-up training classes and as a take-home piece.
  • Measure Factory Student Guide GS70
    Intended use for stand-up training classes and as a take-home piece – required a quick turn-around time as this was the latest addition to the BI tool set within the IDE.
  • Audit Logging in Diver Platform 7.0
    Requested by field service/installers group – intended to gather up in one place desperate information from the help system to aid on-site engineers (ours and the customer’s) in audit logging setup.
  • Access Control File in Workbench Quick Start Guide
    Requested and used by one field service engineer to have as a leave-behind for his customers – again, gathering up in one place desperate information from the help system to simplify the processes required for setting security (called “access control” in the software). This was never formally published as it got replaced by a GUI.

HP PDF Samples (2001-2012)

These samples were produced using PTC Arbortext Editor (XML content based on customized DocBook XSL stylesheets) using a Vasont CMS (content management system) repository.

  • HP SAN Design Reference Guide
    Sections from a 428-page reference guide on Storage Area Networks (SANs) - the audience is pre-sales engineering and storage area network architects - created working with one main SME (subject matter expert) and an illustrator:
    • MacMillan_Reference_SDG_Conceptual
      71-page section of conceptual reference work (PDF pages 10-28 Chapter 2 SAN fabric topologies has examples of artist-generated graphics that I had created with input from my main engineer).
    • MacMillan_Reference_SDG_Linux-SAN-Rules
      2-page section of detailed rules for configuring Linux in an HP SAN.
    • MacMillan_Reference_SDG_EVA-SAN-Rules
      14-page section of detailed rules for one of the HP storage arrays, EVA--Enterprise Virtual Array (PDF pages 11-14 has examples of artist-generated graphics that I had created with input from my main engineer).
  • HP_Storage_System_Scripting_Utility
    CLI (command-line interface) reference guide - audience is SAN administrators - created from scratch working with one remote SME - the author of the utility.
  • Boot-Linux-from-SAN
    HBA (host bus adapter) boot from SAN notes - the audience is SAN administrators - created with Linux HBA engineering group.

Lightbridge Award-Winning Quick Reference Card (1998)

  • Lightbridge Quick Reference Card
    This sample was produced when I, as a freshman writer, reached out to the training, marketing, and account manager groups. Intended to solve the specific problem of guiding retail users on the use of a credit decision software check for buying and activating cell phones. The card was co-created with a local design firm and won two awards from the Society of Technical Communication (Distinction – Boston chapter and Excellence – International).

Lightbridge Award-Winning Quick Reference Card (1998)

  • Lightbridge Quick Reference Card
    This sample was produced when I, as a freshman writer, reached out to the training, marketing, and account manager groups. Intended to solve the specific problem of guiding retail users on the use of a credit decision software check for buying and activating cell phones. The card was co-created with a local design firm and won two awards from the Society of Technical Communication (Distinction – Boston chapter and Excellence – International).