part of docs and minor fixes