SampleWritings

UX Writing Portfolio

This document includes my experience with, thoughts on, and examples of my UX writing. As a technical writer I am often asked to either provide or review and edit the text for the user interface. I have experience working directly in Figma, or even making comments in the code in GitHub.
UX Writing

Automate Tests with GitHub Actions Tutorial

At StackHawk, I was asked to write an end-to-end tutorial for our GitHub integration. This tutorial needed to be simple to implement, removing all barriers of entry so anyone could complete it. I created a tutorial that guides the user through the entire process and does not require any downloads or environment configurations. Afterwards, I was told to add some 'KaaKaww', applying the same voice as in other areas of the product.
GitHub tutorial voice

Event Hooks Examples

As part of my first major feature documentation assignment at Kong, I was asked to document a feature that had been a part of the codebase for a while but was lacking documentation and so not used. The developer who wrote the feature was no longer at Kong, so I had to rely heavily on his notes and PR where he added the new code. Using his notes and the code in the PR, I was able to create a reference doc (also included in my sample writings) as well as several example use cases that I tested myself as I documented them.
api test use-cases

Event Hooks Reference

For one of my first major projects at Kong I was asked to document a feature that was part of the codebase but not yet included in the documentation, and therefore not really usable (docs are important!). The developer who wrote the feature was no longer at the company, so I had to rely on the PR he wrote and some notes he left behind. Using his notes and PR, including the schema and subschema for the different handlers, I was able to create cURL requests and generate sample responses.
api cURL test

CasC bundle management on Operations Center API

My first piece of API documentation. I created a template for how to organize the content based on Tom Johnson's assertion that reference documentation for API endpoints consists of 5 general sections: resource descriptions, endpoints and methods, parameters, sample requests, and sample responses. I took a document written by a developer and tested the endpoints with Postman and curl to create my sample requests. I also created a page on how to authenticate with an API token.
api