document bug better