minor changes and docs
doc Draft