docs, test spec almost done
tests fully specd
updated docs