document up the current architecture a bit based on the workshop the other week