Course Review: Writing in the Sciences

A review of the Writing in the Sciences online course that I recently finished. The course is taught by Dr. Kristin Sainania a Professor of Health Research and Policy at Stanford University. It is a free 8-week series of canned videos, online quizzes, and homework assignments designed to improve your writing. Course Structure Each week […]

Async is the Key to Distributed Work

I wrote A Year Working Remotely after my first year at Automattic — a company now at 1,000 fully distributed employees across 76 countries. This is a 6-year follow on sharing additional learning on work and productivity. A colleague Alister wrote a great post, Three Years of Working from Home, that covers personal care tips, […]

Linting Markdown Syntax

Linting is the process to check code for potential errors and enforce a style guide, but linting is not just for code; you can lint markdown documents for the same reasons. Markdownlint is a Node package to lint markdown syntax, use markdownlint-cli for use on the command-line, or use the Visual Studio Code plugin for […]

Notes on Technical Writing

Over the past year, I’ve worked off and on documentation for WordPress. I started contributing during a launch freeze to help developers transition to the new block editor. I found I enjoy writing documentation, it is rewarding to craft quality documentation that helps people. Over time, I’ve read numerous resources on technical writing and documentation. […]

Docs that make you better

I’m excited to be getting a new camera and being a dork, I’ve been reading the manual online waiting for it to arrive. An interesting thing if you read photography manuals, the documentation does not simply document the camera and features but gives advice on how to be a better photographer. The Fuji manual I […]