These writing samples are publicly available examples of technical documentation that I’ve written. Except where noted, these samples are original works, written and edited by me with links to the online version. These samples are the proverbial tip of the iceberg insofar as the majority of my professional technical writing since 2013 has been proprietary and protected by non-disclosure.
This is an oldie but a goodie, but it’s the only conceptual help doc I could find in my portfolio that isn’t an academic paper. I wrote it based on SME-input and self-experimentation, and it was professionally edited before publication.
Using Readers And Organizations Goals (conceptual/academic)
For a more recent conceptual document (albeit in an academic journal article) on how to collect feedback on different types of online help content, which I co-wrote and edited.
piClinic Tutorial (how to)
I wrote this tutorial this summer as a part of my research on the piClinic Console (https://piclinic.org) to help developers use the API on which the console’s software is built. I also wrote all of the code examples for this tutorial: https://github.com/docsbydesign/piClinic_API_sample.
piClinic – API (reference)
This is an API reference topic for the API featured in the piClinic Tutorial document. I wrote this topic based on the original design and PHP source code.
Blog Post (essay)
I wrote this post on customer-focused documentation before I started working for them. The content is based on information obtained from a collection of independent research, conference presentations, videos, and blog posts—all of which are linked from or cited in the post. The post is currently live on this website.
Aircraft Headset Adapter (overview)
As an example with some soldering-related content, I developed this project for amateur radio. I adapted the circuit from several different articles cited in the post and designed the package. The blog post is currently live on this website.
Other examples of my work
In addition to the preceding samples, the following are other types of content I’ve published. You can also find my academic publications listed at Publications, many of which discuss aspects of developer documentation.
Public Speaking (videos)
- The Inverted Funnel of Developer Documentation, API the Docs, Chicago 2019: https://pronovix.com/event/api-docs-chicago-2019#bob
- Audience, Market, Product ,WriteTheDocs, Portland 2018: https://youtu.be/ax_6cS3JHvY