/ OS



I’m working out a content strategy that works for me. I’ve made many attempts to get to this framework from the abstract and it never worked. Over the past year, I’ve been able to explore it from the largest artifact down (at Chromatic) and have something I think I like.



(instructable — like uncrustable? 😄)

I work in instructions. MVPs building blocks.

So the atomic piece of content for me is an discrete set of instructions.

Everything outside of that is packaging.

With a set of instructions, I can rebuild the content for any platform.

All of my instructables live here:


import * as React from "react";
function MyComponent() {
return <div>This is JSX</div>;
export default MyComponent;

Guiding principles

  1. Start with the verb
    • ✅ “Cut the placeholder text.”
    • ❌ “This placeholder text can be removed.”
  2. Speak in the abstract
    • ✅ “Import the React package.”
    • ❌ “Import all as React from “react”.’
  3. Express warnings and clarifications as post-fix parentheticals. “Be sure” works as a good trigger phrase.
    • ✅ “Return an object. (Be sure to wrap return objects in parens, when returning objects from arrow function expressions.)”
    • ❌ “Return an object. Wrap that object in parens.”
  4. Express navigation instructions thru preceeding parentheticals
    • ✅ “(at the bottom of the file) Export MyComponent as default.”
    • ❌ “Go to the bottom of the file. Export MyComponent as default.”


Every platform has a meta. And it’s often — ironically — not what the original intent of the medium was.





Every platform has a meta. And it’s often — ironically — not what the original intent of the medium was.

Twitter (the text platform) loves visuals right now.
Instagram (the picture platform) screenshots of tweets.
TikTok (the background music platform) loves sketch comedy.

It’s important to package instructables for the target medium.

Here is some high-level examples that I’ll flesh out later.


Twitter loves rich media.

Aspect4:3, 1:1, 16:9


YouTube loves high quality, expertise, explained in a novel way.

But sometimes we have to accept second best. In this case it means thoroughly explaining something as quickly as possible.

if you succeed you get subs, shares, or the opportunity to pitch a more in-depth product.


YouTube Shorts

The most important part of a YouTube short is the first frame. It needs to set the context and raise a question all at once.
Use open captions for key callouts.



Instructable blogs are strange. They’re just a text version of rich media, which has some advantages.

It means that they can be easily automated from rich media content.