more validation work
nits
good 1st draft of documentation