updated documentation so if you run into trouble you know what todo.