Tribal knowledge to internal doc

Turn an informal, rambling explanation into a structured, precise internal doc.