update doc to indicate that IDs or Names are now accepted