some doc fixes, add link to issues