add a section on legacy compatibility