more extensive readme with examples