update menu docs as per conversation in #2397