apply some changes to the interfaces spec docs