This part of my portfolio provides samples of documentation that I have written or updated. I have also organized this documentation
in several different ways to help you get an idea of my progression and processes as a writer.
These writing samples are arranged according to year, starting
with the most recent year. You can download some documents for viewing
or printing on your own computer (right-click and choose Save
As), or you can view them in your web browser if your browser
and operating system allow that. Just click on the icon for the
format you want.
Year |
Document |
Explanation |
2004 - present |
Single Topic Staff Help for CEP
|
Had to arrange complex help and instructions to display on a single page per product manager requirement. Used lots of linking and consistent
structure to make it easier to access the content. |
CEP Questionnaire
|
Form-fillable questionnaire for customers who have recently purchased the product and need to plan for how to implement it. This is also used in conjunction with the customer support team. |
Mobile for Horizon Help
|
Help for a mobile app. I created the basic structure and organization. |
Horizon Help
|
Updated existing content. Moved project from FrameMaker to Flare using import rules and templates. |
Enterprise Admin Help
|
Worked with other writers to create organization and initial content. Maintained content over the course of 2 releases. |
Data Flow Diagram
|
Worked with architects, support, quality assurance, product manager, and engineers to get the initial content and to update each release based on changes or additions. Had to map out the
interactions using Visio and to arrange in a way that was readable in a small page space. |
BLUEcloud Analytics Getting Started Guide
|
Gathered content from interviews with Dev-Ops team. |
BLUEcloud Analytics Data Reference Guide
|
Received technical details from software engineering and had to turn it into a customer-focused form. Needed knowledge of analytics as well the enterprise-level products of the company. My
experience with all the teams was thus quite valuable in this case. |
Web Services (Symphony ILS)
initial version SDK:
current version SDK:
current version Admin Help:
current version Setup Guide:
current version Release Notes:
|
Created the documentation from scratch for the Web Services product. This included an installation guide, Admin help, and an SDK. Initially, we started with an SOA architecture that used
SOAP or REST protocols. Later on, we moved to an ROA framework with REST. We also then moved to the use of Enunciate for getting the examples and comments from the code and putting them into a JavaDocs-style format. |
2003 |
Captiva FormWare 5.1 File System Help
|
Edited Scan section for accuracy. Changed
INI style (in Supplementary Information section) to make the table
more readable. |
2002 |
NextPage Content@ Administrators Guide
|
Initially written by software engineers.
Reorganized and applied corporate style to this guide. |
NextPage Content@ Deployment Guide
|
Worked closely with engineers, QA, consulting
services, and support engineers to coordinate all the information. |
2001
|
NextPage Lotus Notes Content Adapter
|
This documentation was praised by users
and salespeople alike as easy to read and comprehensive. Included
more links and technical detail than commonly done in other existing
documentation. (HTML version no longer available as company has taken down the docs.nextpage.com site). |
NextPage Site Design
|
Some of this information was in an old
manual in Framemaker. I had to update the information and reorganize
it (and add to it in places where it was inadequate) in XML format
for online use. (HTML version no longer available as company has taken down the docs.nextpage.com site). |
NextPage Matrix
|
Only responsible for a couple small articles.
The assigned writer got swamped with work, so we all took over portions
of the entire document to help him out. (HTML version no longer available as company has taken down the docs.nextpage.com site). |
2000 |
NextPage Content Network Manager
|
Given responsibility for this set of documentation
soon after previous author left company. Had to become familiar with
software and update documentation to meet style guidelines. (HTML version no longer available as company has taken down the docs.nextpage.com site). |
NextPage Master Glossary
|
Took all existing, and sometimes contradictory
definitions in all documentation and put everything together in one
location. Also designed links in the documentation that generated
small pop-up window definitions for instant access to a word. (HTML version no longer available as company has taken down the docs.nextpage.com site). |
Midrange Tech Talk
|
Wrote short tip article for trade magazine
about the new advisors for the lastest software release. |
AS/400 Submission (unpublished)
|
Wrote a short piece on peer-to-peer networking
for NextPage and the technology in general. Piece was not accepted
for publication because the magazine changed formats. |
Midrange Article
|
Wrote article about how to use the LPAR
Planning Worksheets. Focused on teaching the worksheets. |
AS/400 Article
|
Wrote article about how to use the LPAR
Planning Worksheets. Focused on teaching about logical partitions. |
IBM V4R5 Planning
|
Updated existing documentation with new
information. Added an online Advisor to aid in planning. |
IBM V4R5 Troubleshooting
|
Got rid of useless Backup and Recovery
document that was a repeat of other books, and focused instead on
troubleshooting. Created an online Advisor to make searching easier. |
IBM LPAR Hardware Planning Guide
|
Took information out of Planning document
and expanded it. Added new hardware and configuration options. Made
the guide easier to access by using lots of tables and figures. |
1999 |
IBM V4R4 Planning for and Setting up Logical Partitions
(Hardware section)
|
I finished my assignment early, so I was
asked to contribute hardware information to a section of this document. |
IBM V4R4M1 Planning and Setting Up Logical Partitions
|
Took over this document from previous writer.
Added graphics and sample configurations to make the information easier
to understand. |
1998 |
IBM V4R4 Backing and Recovering Logical
Partitions
|
This document was the result of a very
rapid development cycle where I had to come in and learn unfamiliar
hardware and software, learn a new style guide, and a new writing
tool (SGML), all while trying to document the new software. I finished
ahead of schedule. |
Uinta "Pinnacle" Online Help
|
Software for banks that needed online help.
I worked with users to find out how they used the existing software
so that I could provide the appropriate help in the right places to
make their jobs easier. |
BYU "Your Computer System" Handout
|
Material for students to learn to not be
afraid of computers, using humor. |
BYU "Attaching Files to Your Email" Handout
|
Material for students to learn how to use
our class communication tools, using humor. |
BYU "Newsgroup News" Handout
|
Material for students to learn how to use
our class communication tools, using humor. |
BYU "Using RoboHelp" Online Help
|
Developed this online help file as a way
of teaching other technical writing students how to use RoboHelp to
create online help. |
1997 |
Beginner's Guide to Searching the Internet
|
Helped write this guide to using search
engines. I was responsible for 2 chapters and for all of the layout
and presentation, including the graphics and graphic design. |