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.
- Measure Factory Overview
Conceptual overview topic.
- Managing Properties
Tasks – click each drop-down link to expose each task.
- Values and Property File Structures
Reference topic with one task – click each drop-down link to expose the sub-topics.
- About Access Control
Conceptual overview topic.
- Access Control Interface
Interface overview topic.
- Access Control Conditions
Short reference topic.
- Properties: Separating Access Control Rules from Data Values
Conceptual topic that was a “break-through” explanation of a rather convoluted solution to simplify security (access control) – was much appreciated as it lessened questions into customer support.
- Configuring Access Control
Overview tasks for a conceptually complex set of task topics.
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:
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).
2-page section of detailed rules for configuring Linux in an HP SAN.
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).
CLI (command-line interface) reference guide – audience is SAN administrators – created from scratch working with one remote SME – the author of the utility.
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).