update docs to reference github issues