some doc and minor fixes