added many notes about how restart fits in with the init api