We have a new heap implementation replacing mem_pool. Add docs on its API and internals, and add a deprecation note to the mem_pool section. Signed-off-by: Andy Ross <andrew.j.ross@intel.com>