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.
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.
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.
Article
Six Questions to Answer Before Implementing a Telemetry Feature
What to consider before adding telemetry to your open-source product.
Article
Understanding Telemetry Features in Open-Source Software
The what and why of telemetry features and insights on developer attitudes.
Tutorial
A Beginner's Guide to Property-Based Testing
How to go from 1 to 10,000 test cases in under an hour.
Tutorial
How to remove condescending language from documentation
A Hacktoberfest adventure in creating more inclusive open-source documentation.
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.
Tutorial
Setting up the alex.js language linter in your project
A practical how-to for linting polarizing language in your Markdown files.
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).
Reference
Managing multiple environments in Contentful
Documentation that explains how space environments work and how to incorporate them into your workflow.
Course
Contentful + Node.js Example App
An application and two corresponding courses that shows how to build applications with Contentful and Node.js.
Reference
Contentful Domain Model
Documentation that walks through the four main entities that makes Contentful... well, Contentful.
Tutorial
Getting Started with Contentful and JavaScript
A guide for setting up the Contentful JavaScript SDK.