Selected technical writing

Guide

ARIA: What it is, when to use it, and how to get started

Semantic HTML will do the trick most of the time. When things get more complex, that's when ARIA comes in.

Read it on the Prismic blog
Reference

Frequently Asked Questions (FAQ) for graphql.org

As part of Google Season of Docs, I worked with the GraphQL Foundation to create an FAQ resource.

Read it on graphql.org
Guide

Functional on the Frontend With fp-ts and pipe

The benefits of adding functional programming practices to your web application, starting with the pipe function.

Read it on DZone
Article

Six Questions to Answer Before Implementing a Telemetry Feature

What to consider before adding telemetry to your open-source product.

Read it on DZone
Article

Understanding Telemetry Features in Open-Source Software

The what and why of telemetry features and insights on developer attitudes.

Read it on DZone
Tutorial

A Beginner's Guide to Property-Based Testing

How to go from 1 to 10,000 test cases in under an hour.

Read it on DEV
Tutorial

How to remove condescending language from documentation

A Hacktoberfest adventure in creating more inclusive open-source documentation.

Read it on DEV
Video

Defining Confidence in Software Testing

A video where I try to make sense of all the vague terminology in testing land, starting with software testing confidence.

Watch it on YouTube
Tutorial

Setting up the alex.js language linter in your project

A practical how-to for linting polarizing language in your Markdown files.

Read it on DEV
Video

What is the Testing Pyramid even?

A video describing what the testing pyramid is and how it relates to web development (in under 5 minutes).

Watch it on YouTube
Reference

Managing multiple environments in Contentful

Documentation that explains how space environments work and how to incorporate them into your workflow.

Read it on Contentful
Course

Contentful + Node.js Example App

An application and two corresponding courses that shows how to build applications with Contentful and Node.js.

Check it out
Reference

Contentful Domain Model

Documentation that walks through the four main entities that makes Contentful... well, Contentful.

Read it on Contentful
Tutorial

Getting Started with Contentful and JavaScript

A guide for setting up the Contentful JavaScript SDK.

Read it on Contentful
Design and Gatsby starter by Marguerite Roth