add a little more detail and structure

particularly regarding the format and option to call in.