fixes, and clearer example descriptions