clean up issue list updating code a bit, and better document the ickiness