made some additions to the guide to make it clearer