design: add more details for the xml transition