Update to reflect futures and doc blocking vs non-blocking