Writing Samples

Dimensional Insight Workbench Topic Samples (2014-2019)

These samples are on a live website for an IDE (integrated development environment). They were produced using MadCap Flare and Capture, using a TortoiseSVN source control repository. The samples listed are topics that I created to support new features.

Dimensional Insight Training Samples (2014-2019)

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

  • Workbench Student Guide
    Intended use for stand-up training classes and as a take-home reference.
  • Audit Logging in Diver Platform 7.0
    Requested by a field service/installers group – intended to gather desperate information from the help system to aid on-site engineers (ours and the customer’s) in audit logging setup.

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 388-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 was a freshman writer. I set out 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).