updating docs and tweaking header