some docs; some improvements