Godin's V is for Vulnerable Mar 17 2024

What are the ABCs of creating art, or shipping product? Is there such a thing? Should there be, and if not why not?

Perusing my bookshelf recently, I came to some conclusions: 1. I will almost surely not read every book I own, even if I exclude reference...


The "Main Learning" book review template Oct 13 2023

The goal of the “Main Learning” book review is to provide a single, execution-ready concept which the reader of the review can put into action. Different readers will have different notions of what constitutes a main, actionable learning, and that...


The 1-2-3 guide to writing a Brief Bio Oct 12 2023

From time to time I’m called on to provide a brief biographical paragraph for one reason or another. Perhaps a conference presentation, an article, or company website. These requests always seem to occur at inconvenient times, when I have other really...


How to write a job description Oct 11 2023

Here’s a handy template for job descriptions.

Writing job descriptions can be easy or hard depending on a number of factors. The main difficulty is likely specifying what someone in the role is expected to achieve. In other words, describing how the...


Situation, Complication, Question, Answer (SCQA) Oct 10 2023

The Situation, Complication, Question, Answer (SCQA) structure was introduced and explained on a couple of pages of Minto’s classic book on corporate communication The Pyramid Principle. Minto provides SCQA as a way to structure an introduction to...


Functional Zero Bugs May 31 2023

A perennial activity in fast-growing companies is managing defects. Equivalently, fixing bugs. Bugs get reported, then routed, then triaged (or triaged, then routed), then scheduled, then at some point far in the future of the bug’s reported occurrence...


Learn to write in a single draft May 17 2023

Writing is something I typically enjoy…provided I have time to write. In the past, “time to write” has usually meant some open-ended period of time when my plate was mostly clear of other obligations. More recently, time to write often means a 15...


Visual Communication Jan 3 2023

Reflecting on the last year, and career experience, I’m going to be spending more time drawing in 2023.

In fact, that would be my single piece of advice to any engineer once the initial programming hurdle is cleared: learn to draw. More specifically...


Recent Win Dec 2 2022

A “Recent Win” is a very brief (2-5 sentences) story about a small increment of delivered business value:

Mary delivered a substantial improvement in lead conversion, from 4.5% to 6.3%, a 28% increase. The company had been losing Sales Qualified...


Refactor risk assessment Nov 7 2022

Refactoring can provide many benefits for an engineering team, including improved readability, maintainability, security, scalability, and performance. In short, refactor should improve the quality of the software.

Careless refactoring can introduce...