update docs
hopefully these help performance
optimization