minor documentation improvements. far from complete