cookbook, updated architecture doc