doc fixes & improvements