Skip to content
Casheeno
All posts

What you get at the end of a project

A working app is the visible part. These are the things that determine whether anyone can maintain it after we leave.

By

What you get at the end of a project

The measure of a handover is whether another team can pick the project up without calling us. Everything below exists to make that true - and we would want the same if we were inheriting it.

The code, and the reasons

  • The repository, with a readable history
  • A README that gets a new machine running
  • Notes on the decisions that are not obvious from the code

The infrastructure, described

Environments, deployment steps, the secrets inventory (not the secrets), DNS, and what each cloud resource is for. Written down, not held in someone's head.

Store and account access

The listings, the signing keys, the analytics and crash reporting - transferred to accounts you own. We have seen too many products stranded behind an agency's Apple account.

A walkthrough with the people who built it

Recorded, so the person who joins in six months can watch it too. Documentation ages; a recording of the reasoning ages better.