changes to make the documentation clearer