some docs, tweaks