fixing up docs
updated docs. fixed a few warnings from check