improved the examples page and updated various and sundry prose