documentation fixes and use blocking put
documentation fixes and use blocking put