more doc updates, mostly formatting but added some new docs for some
things