Post

Work Samples

A collection of work samples and description of my writing process.

Work Samples

iSpeakNerd Work Samples

Hello! Thank you for taking the time to review my writing samples. My writing samples include an overview document, developer documentation for an API tool, a how-to guide, and a user options flowchart. My ideal writing process looks like:

  1. Define - Study the engineering PRs in order to test new features as the first user of the product and learn through doing. I document my steps, the code I run, and the issues I encounter. Design code samples to highlight in documentation.
  2. Research - Meet with the lead engineer of the release to go through my notes, ask questions, and clarify my own understanding. Ask the engineer to review my code samples for accuracy. Decide if visual aids are warranted for any particular processes.
  3. Draft 1 - Write the first draft of the documentation. Run style linters like Alexjs on save. Create technical diagrams as needed for the document.
  4. Style Edit - The next day, edit the draft for grammar, tone, and style according to the organization’s style guide. Add callouts to highlight specific information such as extra information, helpful tips, warnings, and danger signs.
  5. Technical Review - Open a Pull Request and request a technical review from the same engineer and the product owner, as appropriate.
  6. Draft 2 - Incorporate technical feedback into the document.
  7. Stylistic Review - Request a peer review from another technical writer for style, tone, and grammar.
  8. Finalize document - Incorporate stylistic feedback into the document.
  9. Ship - Publish the document.

I hope these writing samples and the process above give you a sense of my technical writing skills. I strive to always be writing framed around solving user problems. To see more, check out my GitHub profile. Thank you!

Work Samples

  1. Project Overview
  2. Developer Documentation
  3. How-To Guide
  4. User Options Flowchart
This post is licensed under CC BY 4.0 by the author.