build for the person after you

the next person may be your future self

i want the things i build to be understandable by someone who was not present for every decision.

that means a new user should be able to find their next step. a collaborator should be able to see what is finished and what still needs a decision. and i should be able to return to a project without relying on a perfect memory of why it works.

good products carry enough context to help people move. good systems do the same for the people maintaining them. i think that is part of the craft: make the important state visible, explain the next action, and leave room for someone else to continue the work.

← back to writing