update several documentation issues