Latest posts

  • Write Down the Decision Behind the Code

    Write Down the Decision Behind the Code

    A code change makes more sense when its reasoning is still nearby. A short decision note can preserve the constraint, trade-off, and lesson that a diff alone cannot show.

    Read more

  • A Portfolio Should Explain the Work

    A Portfolio Should Explain the Work

    A screenshot can show what a project looks like, but it rarely explains why it exists. A useful project page gives readers enough context to understand the decisions behind the result.

    Read more