update the guide to try to be more clear